A persistent workspace for cloud agents.
Run Codex, Claude Code, and OpenCode in the cloud from an API, your terminal, or a shared dashboard. Keep project files, conversation history, and Git revisions between tasks.
Documentation · Quickstart · API · CLI · Self-hosting
- Keep work between runs. Browse and edit files, restore checkpoints, and create independent workspaces for parallel tasks.
- Work from anywhere. Start a run through the API, stream it in the terminal, and review its output and tool activity in the dashboard.
- Connect your tools. Add MCP servers, authorized applications, search providers, and your own model API keys.
- Control access and spending. Use organizations, scoped keys, run budgets, concurrency limits, and usage reporting.
- Keep Git in the loop. Connect a GitHub repository, review changes, and synchronize without force-pushing.
Install Node.js 24, pnpm 10, and Docker. Start Docker, then run:
git clone https://github.com/Macrofold/Macrofold.git
cd Macrofold
pnpm install
pnpm run setup
pnpm devIn a second terminal, from the same directory:
pnpm workerOpen http://localhost:3210. Sign in with demo@example.test and local-only-demo-2026.
Local setup uses simulated agents, a local database, and captured email. No provider account or paid API call is required. The simulator exercises the workflow; real model execution requires a hosted deployment.
Continue with your first run, or use local setup and troubleshooting for more detail.
| I want to… | Start here |
|---|---|
| Understand projects, workspaces, sessions, and runs | Core concepts |
| Integrate an application | API quickstart, SDKs in five languages |
| Use a remote agent from my terminal | CLI guide |
| Connect tools or bring my own API key | Connections |
| Host the service | Deployment guide |
| Understand or contribute to the code | Architecture, codebase map, contributing |
| Read with a coding agent | Documentation index, OpenAPI, contributor instructions |
Bug reports, documentation improvements, and pull requests are welcome. Read CONTRIBUTING.md for setup and review guidance, and SECURITY.md for vulnerability reporting.
Apache 2.0. Third-party components, agent harnesses, and hosted services retain their own licenses and terms; see NOTICE.