Run coding agents (Claude, Codex, and more) in isolated Docker containers with configurable security profiles, multi-project support, and persistent authentication.

git clone https://github.com/WilliamScarbro/skua.git
cd skua
./install.sh

Use a local directory:

skua add myapp --dir ~/projects/myapp

Or use a GitHub repo URL:

skua add myapp --repo git@github.com:your-org/myapp.git

Each project gets adapt artifacts and agent-instruction files:

• .skua/ADAPT.md
• .skua/image-request.yaml
• AGENTS.md
• CLAUDE.md

Workflow:

1. Run automated image adaptation:

skua adapt myapp

skua adapt starts the project container, asks the configured agent to update .skua/image-request.yaml, then applies and builds the adapted project image.

skua run myapp

skua run auto-attaches you to a persistent tmux session in the container. Run:

claude

First run may require login:

claude /login

Credentials are persisted, so later runs usually do not require login again.

Detach from tmux and return to your host shell:

• Press Ctrl-b, then d

Run the same command again to reattach to the same tmux session:

skua run myapp

If attached, run exit.
If detached, stop it from the host:

docker stop skua-myapp

• Docker (daemon running)
• Python 3 + PyYAML
• git

sudo dpkg -i skua_<version>_all.deb
skua init
skua build

pip install pyyaml
ln -s /path/to/skua/bin/skua ~/.local/bin/skua
skua init
skua build

• Quick Start: Installation and first project flow
• CLI Reference: All commands and options
• Configuration Model: YAML resources, environments, validation
• Security Guide: Security profiles, trust model, isolation

For advanced security/environment setup, go to:

• docs/security.md
• docs/configuration.md

Business Source License 1.1 — see LICENSE.