Warning
jackin❯ is in active early development and is not production-ready. Expect breaking changes. Do not treat the current feature set as a compatibility promise.
Jackin is a command-line tool and a terminal console. It runs the Codex coding agent in NVIDIA OpenShell sandboxes.
Jackin builds a container image for each role. It creates one sandbox for each launch, uploads your project into it, starts Codex, and attaches your terminal. OpenShell runs the sandbox and enforces the isolation. Your credentials stay on the OpenShell gateway.
Documentation: https://jackin.tailrocks.com/
- Builds a role image with Docker BuildKit from a role repository: a
Dockerfile, ajackin.role.tomlmanifest, and an OpenShellpolicy.yaml. - Uploads your project as a working tree and a git bundle. Your host
.gitdirectory and your working tree stay untouched. - Gives each sandbox a placeholder instead of your Codex login. The gateway holds the real token.
- Fetches the work of a sandbox back into your repository as git branches with
jackin export. - Tracks your accounts and shows the usage limits of each one with
jackin usage. - Gives a sandbox access to a Docker engine only when a role or a workspace turns on the Docker capability.
Jackin has no packaged release yet. Build it from source:
mise install
mise exec -- mbx +1.99.1 build -p jackin --releaseThe binary is target/release/jackin. You also need the openshell CLI, ssh, git, and docker with buildx on your host, and an OpenShell gateway that you run. See Install jackin and Run a local OpenShell gateway.
jackin gateway add jackin-local --default
jackin doctor
jackin role add my-role ~/roles/my-role
jackin account add codex --name work --chatgpt-from ~/.codex
jackin workspace add my-app ~/Projects/my-app
cd ~/Projects/my-app
jackin load my-roleRun jackin on a terminal to open the console. See the Quick start for the full walkthrough and the command reference for every option.
- Why jackin
- Install jackin
- Quick start
- Core concepts
- Run a local OpenShell gateway
- Accounts
- Docker capability
- Security model
- Create a role
| Repository | Description |
|---|---|
| jackin | The CLI and the console (this repository) |
| jackin-agent-smith | A code review role |
| jackin-the-architect | A role with the Rust toolchain, for developing jackin |
| jackin-sentinel | A role that proves jackin works end to end |
Read CONTRIBUTING.md, COMMITS.md, and AGENTS.md. The target design is in rewrite/DESIGN.md.
jackin❯ is an independent personal project by Alexey Zhokhov. It is not affiliated with or endorsed by any employer or client of the author.
This project is licensed under the Apache License 2.0.