Coding agents

Adria provides the computer where your agent works. The standard image includes Codex, Claude Code, and Pi. Connect the agents you use once from your local computer, then launch them in any of your sandboxes. Personal configuration imports are optional.

Connect an agent

After cube login, run the relevant command locally:

The command prompts for the credential with terminal echo disabled. For Pi, choose the provider you use, such as anthropic, openai, or google.

Check stored configuration with:

cube auth

This reports whether credentials are configured, not whether they have remaining credit. API keys use the model provider's API billing. Importing settings does not import subscription login sessions or convert a subscription into API credit.

Launch in a sandbox

Local: connect to a persistent agent terminal:

cube connect feature/payments --tmux agent

Sandbox: launch your configured agent:

codex
# Or: claude
# Or: pi

The agent works in the sandbox's repository and can use its build tools and services. Detach with Ctrl+B, then D; reconnect with the same local command. For independent tasks, use separate sandboxes.

Optional: bring your settings and skills

Import your local setup if you want the remote agent to use your personal instructions, skills, MCP tools, or extensions. This is separate from credentials. Follow Bring your agent setup to preview and save it. Project configuration committed to Git already arrives with your repository.

Replace or remove credentials

Run the same cube auth <agent> command again to replace a credential. New agent launches use the new value. To disable future credential delivery:

cube auth codex --remove

Already running agents can retain credentials in memory. Revoke a credential with its provider if you need to invalidate it. cube logout revokes the local Adria login and preserves centrally configured agent credentials.

Remove a saved configuration import separately:

cube config remove codex