Documentation
Learn Moonfold.
Install it, connect the agents you already use, and keep a task moving when one of them runs out. 45 pages, written in the open and editable on GitHub.
Get started
Install Moonfold, run it the first time and keep it up to date.
- Install MoonfoldMoonfold runs coding agents on your computer and lets you control them from its desktop app or a web browser. Set up the machin…
- Welcome wizardMoonfold shows a setup flow when you open a new installation or connect to the hosted app for the first time. Existing workspac…
- Updating MoonfoldThe app you use and the server running your agents can be on different machines. When a server is behind your web or desktop ap…
- Remote accessConnect a phone, browser, or another desktop app to Moonfold running on a different machine. That machine must stay running and…
- Running Moonfold in the backgroundOn Linux and macOS, Moonfold can run as a service for your user so you do not need to keep a terminal open.
Work with agents
Threads, permissions, handoff and the tools agents can use.
- Working with threadsUse a new thread for a separate task. Choose New worktree when its code changes need a separate branch and working directory.
- Messages and contextGive the agent a task in the composer. Add files, quote a previous response, or include a skill when the task needs more context.
- Permission modesPermission modes control when an agent needs your approval to act. Choose a mode in the message composer; it applies to that th…
- Provider handoffWhen an agent reaches its usage limit, or you want another agent to take over, Moonfold can move the thread to a different prov…
- Context in portable handoffsFor moving a thread to another provider when one hits its limit, see Provider handoff. This page explains how much history trav…
- Usage and limitsOpen Usage from the sidebar or the command palette, or press mod+u on web and desktop when the terminal is not focused. Customi…
- Scheduled tasksA scheduled task sends a prompt to an agent on a schedule. Create and edit tasks in Settings → Scheduled tasks; agents can also…
- MemoriesMemories are short notes that agents receive at the start of every turn, so you don't have to repeat a preference in each conve…
- PluginsA plugin gives agents extra skills and, optionally, MCP servers. Manage plugins in Settings → Plugins. Each environment has its…
- Agent instructionsAgents read standing instructions from Markdown files: AGENTS.md (Codex and most agents) and CLAUDE.md (Claude Code), both in y…
- ArtifactsEverything a thread produced or was given is listed under Artifacts in the thread details panel: each file its agent changed, n…
- Computer useComputer use lets agents see and operate desktop apps on the environment's computer: read a window's controls, take screenshots…
- Agent browsingAgents can open web pages in Moonfold's browser and work with them. Settings → Integrations → Agent browsing decides what they…
Providers
Connect the agent CLIs you already use, with your own logins.
- CodexUse your ChatGPT plan or an existing Codex CLI login to code in Moonfold.
- ClaudeMoonfold uses Claude Code's login and configuration. Start with the default provider for one account; provider setup covers ins…
- Gemini CLIGemini CLI speaks ACP, so Moonfold runs it through the generic ACP integration; there is no separate Gemini provider.
- ACP providersMoonfold can run installed ACP commands or coding agents from the official ACP Registry. Registry agents bring their own models…
- CursorCursor V2 runs through the official @cursor/sdk TypeScript package. It does not use Cursor's ACP transport for V2 execution.
- OpenCodeInstall and authenticate OpenCode on the machine running your environment, then enable it in Settings > Providers. See provider…
- AntigravityMoonfold runs Google's official Antigravity ACP agent on your selected environment. It has its own sign-in, separate from the A…
- PiMoonfold can use your existing Pi coding agent installation while keeping Pi's models, auth, extensions, skills, context files,…
- Muse CodeMuse Code is a beta integration and is disabled by default. Install Muse Code on the machine hosting your environment, then run…
More
Everything else in the guide.
- Activity logOn web and desktop, consecutive tool calls appear as an expandable summary. Open it to inspect commands, tool inputs, status, a…
- Appearance and themesOn web and desktop, open Settings → Appearance to choose a theme and follow the system appearance or stay in light or dark mode…
- Import browser sessionsThe desktop app can import cookies from another browser so you can reuse its signed-in sessions in the preview browser.
- Use Moonfold as your default browserOn macOS, the desktop app can be your default web browser. Links you open from other apps then open in Moonfold. When the threa…
- DevicesThe Device panel shows a live iOS Simulator or Android Emulator next to a thread, so you can watch an agent verify mobile work…
- Visual repliesAgents can answer with a page instead of only text: a chart, table, diagram, image collage, or mockup. Ask for one ("show this…
- KeybindingsCustomize shortcuts in Settings → Keybindings on web and desktop. That page also lists the command IDs and defaults available i…
- Keyboard focusThe command palette keeps focus while open. Closing it returns focus to the composer. While the palette or model picker is open…
- Open source licensesMoonfold includes third-party software and adapted assets. To read their license and attribution notices:
- Outside agentsAgents that Moonfold did not start can work with an environment through its MCP server. They can read projects and threads, sta…
- Settings and project overridesOn web and desktop, the "Applying settings for …" sentence at the top of Settings pages picks the project and environment a cha…
- Prompt linksA prompt link opens Moonfold with a prompt ready to send. Use one to share a prompt on social media, or to put a one-click fix…
- Files in question answersWhen an agent asks a question that accepts a custom answer, use Attach files or paste an image into the answer field.You can se…
- SnapShotsA SnapShot captures the window you are working in and attaches it to your current draft. The attachment carries the app name an…
- Source controlMoonfold integrates with GitHub, GitLab, Forgejo, Gitea, Bitbucket, Azure DevOps, and GitCafe to clone and publish repositories…
- Product usage dataMoonfold collects no product usage data by default and ships no analytics key.
- Terminal historyEach terminal keeps up to 5,000 lines and 8 MiB of scrollback on its environment server. Moonfold removes the oldest output whe…
- Threads from older Moonfold versionsOn your first V2 launch, Moonfold copies the V1 database, state.sqlite, into statev2.sqlite in the same data directory and migr…
No page matches that.
Missing something? Every page lives in the repository and takes pull requests.