moi
πΎ MOI: agent-agnostic generative UI workspace. Give your agent a skill and let it build software around itself.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/moi-computer/moi with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/moi-computer/moi'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/molefrog--moi)HTML
<a href="/listings/molefrog--moi"><img src="/api/listings/molefrog--moi/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Make sure [Bun](https://bun.sh) 1.3 or newer is installed. moi uses it to run the web server and bundle the dynamic UI.
Install the `moi-computer` package from npm and start the web UI:
bun i -g moi-computer moi start # http://localhost:13337
Then connect your agent: [Claude Code and Codex](#claude-code-and-codex), [OpenClaw](#openclaw), or [Hermes](#hermes).
Learn how to:
- [Run moi as a service](#run-moi-as-a-service) - [Update moi](#update-moi)
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 228 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- ```
- ββββββββββ ββββββ ββ
- ββββββββββ ββββββ ββ
- ββββββββββ ββββββ ββ
- THE UI FOR YOUR AI
- ```
- [](https://www.npmjs.com/package/moi-computer) [](https://discord.gg/9kj3y9Pfk)
- An extendable visual workspace where your AI agents build their own UI.
- See [moi.computer](https://moi.computer) for what it is and how it works.
- Moi gives your agent of choice a UI it can reshape on the fly and grow into your
- personal software. Under the hood, the agent writes and embeds live components
- wired to real data: APIs, local files and commands, MCP servers.
- Works with the harness you already use:
- <p align="center">
- <a href="#claude-code-and-codex"><img src="assets/harnesses/claude.svg" width="16" alt="" /> <strong>Claude Code</strong></a>
- <a href="#claude-code-and-codex"><img src="assets/harnesses/codex.png" width="16" alt="" /> <strong>Codex</strong></a>
- <a href="#openclaw"><img src="assets/harnesses/openclaw.svg" width="16" alt="" /> <strong>OpenClaw</strong></a>
- <a href="#hermes"><img src="assets/harnesses/hermes.png" width="16" alt="" /> <strong>Hermes</strong></a>
- </p>
- # Features
- - **Bring your own agent**. Connect the agent you already use.
- - **Workspace**. The folder where your agent (e.g. Claude Code) runs and keeps
- its data. It gets a special skill that teaches it how to communicate with Moi.
- - **Theme**. The agent can modify the appearance of the workspace for you:
- fonts, color scheme and more.
- - **Scratchpad**. A shared canvas where you ideate together with the agent: ask
- it to draw diagrams, add feedback or comments, visualize knowledge and plans.
- - **Overview**. A dynamic home made of small widgets wired to the data from
- your workspace. They can be rearranged, modified, and completely customized.
- - **Views**. An app embedded in the workspace that lives in its own tab. Build
- complex interfaces: CRMs, task trackers, second brain storage, customer
- support views, etc.
- <table>
- <tr>
- <td align="center"><img src="assets/screenshots/moi-moi-dash-2.webp" alt="Overview" /><br /><sub>Widgets wired to live project stats</sub></td>
- <td align="center"><img src="assets/screenshots/moi-magazin-scratch-2.webp" alt="Scratchpad" /><br /><sub>Order funnel on the scratchpad, live from Postgres</sub></td>
- <td align="center"><img src="assets/screenshots/moi-magazin-products-2.webp" alt="Products view" /><br /><sub>Use the agent as a copilot when working with products</sub></td>
- </tr>
- <tr>
- <td align="center"><img src="assets/screenshots/moi-magazin-dash-2.webp" alt="Store dashboard" /><br /><sub>E-commerce store dashboard connected to Postgres and Resend</sub></td>
- <td align="center"><img src="assets/screenshots/moi-view-screen.webp" alt="Roadmap view" /><br /><sub>Build a Roadmap view with epics and pull requests</sub></td>
- <td align="center"><img src="assets/screenshots/moi-scratch.webp" alt="Scratchpad canvas" /><br /><sub>Sketching architecture together with the agent</sub></td>
- </tr>
- <tr>
- <td align="center"><img src="assets/screenshots/moi-color-grading.webp" alt="Color grading review" /><br /><sub>Custom view for color grading</sub></td>
- <td align="center"><img src="assets/screenshots/moi-home.webp" alt="Home screen" /><br /><sub>Home screen with your workspaces</sub></td>
- <td align="center"><img src="assets/screenshots/moi-linear.webp" alt="Issues view" /><br /><sub>Issues view, a lightweight Linear-like tracker</sub></td>
- </tr>
- </table>
- # Quick start
- Make sure [Bun](https://bun.sh) 1.3 or newer is installed. Moi uses it to run the web server and bundle the dynamic UI.
- Install the `moi-computer` package from npm and start the web UI:
- ```sh
- bun i -g moi-computer
- moi start # http://localhost:13337
- ```
- Then connect your agent: [Claude Code and Codex](#claude-code-and-codex),
- [OpenClaw](#openclaw), or [Hermes](#hermes).
- Learn how to:
- - [Run Moi as a service](#run-moi-as-a-service)
- - [Update Moi](#update-moi)
- # How it works
- Moi runs locally as a CLI and web UI connected to your agent. The workspace
- skill teaches the agent how to call the CLI, which updates the UI using your
- files, commands, APIs, and MCP servers.
- The core is `moi` command that both agent and you can use to modify the workspace.
- Everything gets propagated to the UI instantly.
- ```mermaid
- %%{init: {"theme": "base", "themeVariables": {"primaryColor": "#ffffff", "primaryTextColor": "#111111", "primaryBorderColor": "#111111", "lineColor": "#737373", "edgeLabelBackground": "#ffffff"}}}%%
- flowchart LR
- Agent["Your agent, e.g. Claude Code"] -->|"uses moi skill"| CLI["moi CLI"]
- CLI -->|"updates"| UI["UI"]
- ```
- Moi also stores the all widgets and views as code to keep the workspace filesystem
- as a source of truth.
- Updates installed from the UI restart Moi and reload the browser automatically.
- The app checks npm at most once an hour while it is open, retrying in five
- minutes if the registry could not be reached; a closed app makes no network
- calls of its own.
- # Connect an agent
- A workspace is the folder where your agent runs and stores its data. Moi adds
- a `.moi/` folder and the skills the agent needs to work with the UI.
- You can connect a workspace in either of these ways:
- - Open [http://localhost:13337](http://localhost:13337) and create a workspace
- or import one that Moi found on your computer.
- - Run `moi init` in a folder. Moi detects the harness from the folder's Hermes
- profile, OpenClaw agent, or Claude Code or Codex history. If detection is
- ambiguous, it asks you to choose a harness.
- ## Claude Code and Codex
- Open Claude Code or Codex in your project folder and paste this prompt:
- ```
- Set up the Moi workspace for this project. Fetch https://moi.computer/INSTALL.md, and follow the steps.
- ```
- To set it up manually, run:
- ```sh
- moi init --harness=claude-code # or --harness=codex
- moi start # or run Moi as a service
- ```
- The project folder becomes the workspace. You can create as many workspaces as
- you need.
- ## OpenClaw
- [OpenClaw](https://openclaw.ai/) is a self-hosted harness for running one or
- more always-on agents. Its channels connect agents to Slack and other
- messaging services.
- Moi connects each OpenClaw agent to one workspace. See the
- [OpenClaw documentation](https://docs.openclaw.ai/cli/agents) to add or manage
- agents.
- Run `moi openclaw init` to connect your agent. If Moi finds more than one, it
- lists them so you can rerun the command with the agent you want:
- ```sh
- moi openclaw init
- moi openclaw init <agent> # only needed when you have multiple agents
- moi start # or run Moi as a service
- ```
- Your agent's workspace will show up at `http://localhost:13337`.
- ## Hermes
- [Hermes](https://hermes-agent.nousresearch.com/) is a self-hosted personal
- agent from Nous Research.
- Moi connects each Hermes profile to one workspace. A profile is a separate
- agent identity with its own model, keys, persona, skills, and memories.
- Run `moi hermes init` to connect your profile. If Moi finds more than one, it
- lists them so you can rerun the command with the profile you want:
- ```sh
- moi hermes init
- moi hermes init <profile> # only needed when you have multiple profiles
- moi start # or run Moi as a service
- ```
- The profile's workspace appears at `http://localhost:13337`. To add another,
- create it with `hermes profile create <name>`, then run `moi hermes init` again.
- Moi connects to Hermes through its built-in
- [Agent Client Protocol](https://agentclientprotocol.com/) server. It starts a
- `hermes -p <profile> acp` process and communicates over stdio, so there is no
- gateway, port, or additional API key to configure.
- # Manage Moi
- ## Run Moi as a service
- Instead of keeping `moi start` in a terminal, install Moi as a user-level
- service. It starts on login, restarts on crash, and survives reboots
- (launchd on macOS, a systemd user unit on Linux; no root needed):
- ```sh
- moi service install # install and start
- moi service # state, unit path, server version
- moi service logs -f # follow server logs
- moi service restart
- moi service uninstall
- ```
- Anything your agents need belongs in the workspace env (`moi env set` or
- `.env`). To capture shell variables instead, run
- `moi service install --env MY_TOKEN,OTHER`.
- Rerun `moi service install` after changing captured vars (or moving bun). On
- macOS the first install may show a "background item added" notification for
- "moi"; that is the Moi service. On headless Linux, lingering is enabled
- automatically when possible so the service outlives your SSH session.
- ## Update Moi
- ```sh
- moi update # update to the latest release
- moi update --check # only check; exit 0 up to date, 1 update available, 2 check failed
- ```
- `moi update` checks npm for the latest release and updates through whichever
- package manager owns the install (bun, npm, pnpm, or yarn). A service-managed
- server is restarted onto the new version; a foreground `moi start` only gets
- a warning, so restart it yourself. Prerelease installs (`β¦-next.N`) are left
- alone. `--check` changes nothing and is made for scripts and agents.
- `moi status` shows when the running server and CLI versions differ, however
- the update happened.
- # No crypto token
- Moi has **no** cryptocurrency, token, coin, or NFT, official or otherwise, on
- any chain, and never will. Any token using the Moi name, logo, or the
- maintainer's name (on pump.fun, Solana, or anywhere else) is an unauthorized
- scam with no affiliation to, endorsement from, or benefit to this project.
- The maintainer will never announce, endorse, or accept proceeds from a token.
- Don't buy it, and report it to the platform where it's listed.
- License: [Elastic 2.0](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.