Run Codex, Claude Code, OpenCode, Hermes, DeepSeek Harness, or Pi through an API, CLI, or dashboard. Give agents persistent files they can return to across tasks.
Start building
- Build with AI: copy a setup prompt into your coding agent and describe your feature.
- API quickstart: create a project, submit a task, and print its result.
- Dashboard quickstart: run and review a task without writing code.
Choose where Macrofold runs
| Option | You manage | Start here |
|---|---|---|
| Macrofold Cloud | Your application, projects, permissions, and usage | Connect to Cloud |
| Self-hosted | Your Macrofold deployment and its infrastructure | Self-hosting guide |
The same API, SDK, CLI, and feature guides apply to both. Use the origin and credentials for your deployment; enabled integrations, model availability, and limits depend on its configuration. For a free first experiment, use local simulation.
Learn the essentials
A project groups work. A workspace holds its files. A run performs a task. Core concepts explains what persists.
- Runs and agents: select a harness, stream output, continue, and cancel.
- Workspaces and Git: edit files, restore checkpoints, and synchronize a repository.
- Share files between agents: take turns in one workspace or use separate branches in parallel.
- Connections: model keys, named app accounts, and MCP tools.
- Triggers and schedules: start work from Slack, webhooks, or recurring prompts.
- Dashboard and billing: review work, manage access, and control usage.
Build a customer-facing agent
Read the customer identity guide, then run the personal-agent application. It keeps customer ownership, named agents, files, conversations and schedules connected. Add the optional file memory starter or use customer-data recipes for an existing database or MCP service. Each guide includes setup, examples, recovery, validation and an explicit AI reading map.
Go deeper
API overview · SDKs in five languages · CLI · Streaming · Errors and retries · OpenAPI · Troubleshooting
Develop and operate
Local simulation, Docker, and cloud staging are development modes. Self-hosting covers operating a deployment. Architecture, the codebase map, and contributing explain how to change Macrofold itself.
Anyone can contribute a harness through the Unified Harness Interface, reusing the existing execution, streaming, and persistence system.