Grokbot Harness documentation
Build your desktop agent workspace, connect a model, and turn a task into files you can use.
Get started
Customize your workspace
| Guide |
What you will learn |
| Sandbox and data |
Mount projects, choose an image, add reference folders, and back up data |
| Permissions |
Separate mounts, Mac tools, Auto-review, and Keychain |
| Starter marketplace and Bot recipes |
Install the pinned Skill/MCP starters, configure Host-owned credentials, and import a local Bot recipe |
| MCP, plugins, and Skills |
Connect tools and manage reusable capabilities |
| macOS packaging |
Build an app with your icon and connect it to the Host |
Develop and maintain
| Guide |
What you will learn |
| Architecture |
How desktop, Host, Agent, sandbox, and model API work together |
| Package map |
Find packages by responsibility and distinguish execution layers |
| Host extension map |
Registration, dependencies, and service boundaries |
| Development |
Find the right files, rebuild, and choose tests |
| Maintainer workflow |
Take one useful issue through implementation, independent review, and merge |
| CI |
See the required offline checks and what they establish |
| Source recovery |
Fragments, bundles, manifests, and strict TypeScript |
| Verification |
Existing evidence and workflows that need broader coverage |
| Issue triage |
Reproducible issue reports, label meanings, and triage rules |
| Publish docs website and Wiki |
Build/deploy the GitHub Pages website and optionally export the native Wiki |
New users: start with Installation → Configuration → Sandbox → Permissions.
Developers: start with Architecture → Package map → Development.
Commands run from the repository root unless a page says otherwise.
Documentation · Get started · Configuration · Project