Manasprites

A persistent coding agent you can talk to from your terminal or over HTTP.

manasprites sprite create --file agent.json
manasprites prompt "Build a Python reading-list CLI. Save to JSON. Write and run tests."
manasprites prompt --continue "Add search. Keep the storage format and test the new command."

Manasprites creates a Sprite, prepares the workspace, and starts the agent service. prompt streams the answer and tool activity, then exits when the turn finishes. Follow-ups resume the same conversation and files.

Setup

You need macOS or Linux, Python 3.9+, curl, an authenticated Sprites CLI, and OPENAI_API_KEY exported. Install the CLI:

curl -fsSL https://github.com/managoat/manasprites/releases/download/cli-v0.2.0/install-cli.sh | sh
export PATH="$HOME/.local/bin:$PATH"

Save this as agent.json, replacing your-sprites-org:

{
  "name": "my-agent",
  "org": "your-sprites-org",
  "url_auth": "public",
  "agent": {"runtime": "codex"}
}

Run the three commands at the top. The CLI reads agent.json by default and loads the saved URL and API key for you. Use --file path/to/agent.json to select another config.

Starting with a project? Add repository, env, and bootstrap to the config; Manasprites clones it, imports the named variables, and runs your setup commands. See the complete example and configuration reference. Already have a Sprite? Install the service directly.

Conversations

manasprites conversations
manasprites prompt --conversation CONVERSATION_ID "Run the tests and fix any failures."
manasprites watch CONVERSATION_ID

--continue uses your last conversation on this Sprite. watch replays the latest turn and follows it without submitting work. Ctrl-C stops watching; the agent keeps working. One turn runs at a time across the shared workspace.

For longer prompts or scripts:

cat task.md | manasprites prompt -
manasprites conversations --json

The service also exposes an authenticated HTTP API and SSE streams for your own app. See the CLI and HTTP walkthroughs.

Docs and status

The service is a v0.1.0 preview; the CLI preview installs separately. Codex has live inference and continuation coverage; Claude still needs live qualification. There is no bundled web UI.

Setup makes no model request; prompts use your inference account. The generated bearer key grants owner access, and tool permissions default to auto_allow. Choose url_auth: sprite for private access through a tunnel.

• Provisioning: repositories, environment, bootstrap, and retries.
• Conversations: CLI commands, HTTP examples, and streaming.
• Operations: configuration, service management, backups, and upgrades.
• API specification · OpenAPI.
• Development: tests and release builds.
• Acceptance record: verified behavior and remaining work.

Built with Managoat ACP, Runtimes, and Sandbox. Apache-2.0.