Quick Start

Mapache Tools runs coding agents in isolated, Git-linked serverless workspaces. Use the webapp when a project needs its own runtime image, credential set, and terminal session without polluting your local machine.

Start a Workspace

1. Open Mapache Tools
2. Create or select a workspace.
3. Connect the Git repository you want the agent to work in.
4. Choose a session image for the project. See the runner matrix in Launch a Session when you need to compare the standard images.
5. Launch the workspace session.

Each session provisions a Cloud Run backed runner with a terminal-first workflow, workspace file sync, and browser-visible state.

Each session also gets its own Pi conversation thread. Multiple sessions can share one workspace and home environment, but their Pi chat histories stay separated by session.

Scope Credentials

Store provider credentials in your profile, then enable only the providers a workspace needs. Mapache writes the generated auth files and environment values inside the workspace boundary so different projects can use different auth surfaces safely.

Verify Changes

Inside a session, use the terminal to run the project checks that matter for the current change. For frontend work in this repository, run:

npm run build

For community site work, run:

cd community
npm run build