Enter boss mode.

Delegate dev loops to Claude Code, Codex CLI, Gemini CLI, OpenCode or any AI coder. Runs autonomously for hours in an isolated Podman sandbox. Subscription/device auth is primary; API keys are supported fallback.

Quick Start

Install Boss globally to launch AI agents in an isolated Podman container.

Prerequisites

• Node.js >= 18
• Podman (installed automatically by boss init, or install manually)
• One auth method for the agent(s) you use: subscription/device auth (recommended) or API key fallback

Setup

# Install Boss globally
npm install -g @sublang/boss

# Initialize Podman, pull sandbox image, create config
boss init

# Optional fallback API keys
# Edit ~/.boss/.env if you prefer key-based auth

Run

# Start the sandbox container
boss start

# Open Claude Code in a workspace
boss open myproject claude

# Open Claude Code with extra args
boss open myproject claude -- --resume

# List running sessions
boss ls

# More features
boss -h

Then authenticate in-session (recommended), or set fallback API keys in ~/.boss/.env.

If any step fails, see Troubleshooting.

Supported Agents

Built-in (no configuration needed):

Agent Name	Binary	Provider	Primary Auth	Fallback Env Var
claude	claude	Anthropic	claude setup-token	ANTHROPIC_API_KEY
codex	codex	OpenAI	codex login --device-auth	CODEX_API_KEY
gemini	gemini	Google	NO_BROWSER OAuth flow	GEMINI_API_KEY
opencode	opencode	OpenCode	Host credential forwarding	MOONSHOT_API_KEY

For full auth details and caveats, see Agent Configuration.

Configuration

File	Purpose
~/.boss/config.toml	Container settings, SSH keys
~/.boss/.env	Auth env vars (subscription tokens and API-key fallbacks; loaded on start)

Documentation

• Installation Guide — prerequisites, setup, platform notes
• CLI Reference — all 6 commands with options, examples, and exit codes
• Agent Configuration — authentication, autonomy settings, API keys
• Workspace Guide — creating, listing, and removing workspaces
• Tmux Quick Reference — detach, reattach, pane splits, scrollback
• Troubleshooting — common issues and fixes

Contributing

See Development Guide for running from source and using dev images.

We welcome contributions of all kinds. If you'd like to help:

• 🌟 Star our repo if you find Boss useful.
• Open an issue for bugs or feature requests.
• Open a PR for fixes or improvements.
• Discuss on Discord for support or new ideas.

License

Licensed under the Apache License 2.0.