Getting Started

Context Hosting runs multiple coding agent sessions (Claude Code, OpenAI Codex, Amazon Bedrock) in parallel, in isolated Kubernetes pods. Manage them from a web dashboard or CLI.

Prerequisites

  • Docker
  • kind (Kubernetes in Docker)
  • kubectl
  • Rust toolchain
  • Node.js 20+

Install

curl -sSL https://context-hosting.com/install | sh

Quick Start (Local)

# Build CLI, Docker image, Kind cluster, Postgres
make init

# Start API on :3000 + UI dev server on :5173
make start

# Open the dashboard
open http://localhost:5173

Create Your First Sandbox

# Create a sandbox with Claude Code (default agent)
sandbox create my-agent

# Or use OpenAI Codex
sandbox create my-agent --agent codex

# Attach to the agent session
sandbox agent my-agent

# Attach to a plain bash shell
sandbox terminal my-agent

Session Sharing

Both the browser and CLI attach to the same tmux session:

  • Browser connects via WebSocket proxy through the API server
  • CLI connects via kubectl exec directly into the tmux session
  • Switching between them is seamless — same scrollback, same state

To detach from a CLI session: press Ctrl+B, then d (do NOT use Ctrl+C — it kills the session).

Next Steps