Skip to content
jackin'

Quick Start

Load your first agent

Section titled “Load your first agent”

In jackin’, the first thing you choose is usually an agent class. That is the tool profile you want to run. agent-smith is the default starter class included by this project.

  1. Navigate to your project directory

    Terminal window
    cd ~/Projects/my-app

  2. Load an agent

    Terminal window
    jackin load agent-smith

    The first time you run this, jackin’ will:

    • Pull the construct base image
    • Clone the agent-smith repository
    • Build a derived Docker image with Claude Code installed
    • Create an isolated Docker network
    • Launch the container with your current directory mounted

  3. You’re inside

    Claude Code starts automatically with full permissions inside the container. Your project directory is mounted at the same path, so the agent sees the same file layout you do.

  4. Exit when done

    Press Ctrl+C or type /exit in Claude Code to leave. The container stops, but its state is persisted for next time.

If you already know you want a more specialized agent class, swap agent-smith for something else such as the-architect.

Use the interactive launcher

Section titled “Use the interactive launcher”

If you prefer a visual interface:

Terminal window
jackin launch

This opens a TUI where you can:

  • Pick from saved workspaces or use the current directory
  • Preview which directories will be mounted
  • Choose which agent to load

Reconnect to a running agent

Section titled “Reconnect to a running agent”

If you close your terminal but the agent is still running:

Terminal window
jackin hardline agent-smith

This reattaches your terminal to the running container’s session.

Stop an agent

Section titled “Stop an agent”
Terminal window
# Stop a specific agent
jackin eject agent-smith


# Stop ALL running agents
jackin exile

Common workflows

Section titled “Common workflows”
Terminal window
# Start of day — load agent into your project
jackin load agent-smith ~/Projects/my-app


# Work with Claude Code inside the container...


# End of day — stop the agent
jackin eject agent-smith

Next steps

Section titled “Next steps”