Manage all sessions from a web dashboard:

node dashboard/server.js

Opens at http://localhost:7680 with:

• Create new sessions with volume mounts and initial queries
• All sessions listed with start/stop/delete controls
• Live iframe views of active sessions

Optional integrations

• ./scripts/setup-gemini.sh - Add Gemini CLI access
• ./scripts/setup-slack.sh - Add Slack read access

What's included

• Ubuntu 24.04
• Node.js 24 (LTS)
• Claude Code 2.1.32 (with optimized system prompt - starts at ~5% context instead of ~9%)
• GitHub CLI with auto-configured git user
• Playwright MCP with Chromium
• Gemini CLI 0.26.0 (optional - requires API key)
• Slack read-only skill and tool (optional - requires token)
• DX plugin, custom status line, shell aliases
• ttyd web terminal + tmux

Sensible defaults

• Claude Code version pinned (currently 2.1.32)
• autoCompactEnabled: false - prevents automatic context compaction
• promptSuggestionEnabled: false - disables prompt suggestions
• Auto half-clone hook at 85% context usage
• --dangerously-skip-permissions enabled (because it's containerized)

Conversation history and memory

Each session's data persists locally at:

~/.config/safeclaw/sessions/<session-name>/

This maps to /home/sclaw/.claude/projects/ inside the container and includes:

• Conversations - JSONL files (one per conversation)
• Memory - Auto memory at -home-sclaw/memory/MEMORY.md, loaded into the system prompt each conversation

Rebuilding containers or restarting sessions won't affect your history or memory.

Authentication

Tokens are stored in ~/.config/safeclaw/.secrets/ and injected as env vars on each run. The filename becomes the env var name.

| File | How to generate | |------|-----------------| | CLAUDE_CODE_OAUTH_TOKEN | claude setup-token (valid 1 year) | | GH_TOKEN | gh auth token or create a PAT at github.com/settings/tokens | | GEMINI_API_KEY | Optional - get from aistudio.google.com | | SLACK_TOKEN | Optional - ./scripts/setup-slack.sh |

You can add any additional secrets by creating files in the .secrets/ directory.

Scripts

| Script | Description | |--------|-------------| | scripts/build.sh | Build the Docker image and remove old container | | scripts/run.sh | Start/reuse container, inject auth, start ttyd. Use -s name for named sessions, -v for volumes, -n to skip opening browser, -q "question" to start with a query. | | scripts/setup-gemini.sh | Set up Gemini CLI (optional) | | scripts/setup-slack.sh | Set up Slack integration (optional) | | scripts/manage-env.js | Manage environment variables (list, add, delete) | | dashboard/server.js | Web dashboard for managing multiple sessions |

Aliases

Inside each container, these aliases are available:

| Alias | Command | |-------|---------| | c | claude | | cs | claude --dangerously-skip-permissions | | g | gemini |

npm scripts

| Command | Runs | |---------|------| | npm run build | ./scripts/build.sh | | npm start | ./scripts/run.sh | | npm run dashboard | node dashboard/server.js | | npm run dashboard:dev | nodemon dashboard/server.js | | npm run setup-gemini | ./scripts/setup-gemini.sh | | npm run setup-slack | ./scripts/setup-slack.sh | | npm run manage-env | node scripts/manage-env.js |

Skills

Defined in setup/skills/.

| Skill | Description | Requires | |-------|-------------|----------| | gemini | Web research, multimodal tasks (PDFs, images), second opinion | GEMINI_API_KEY | | slack | Read Slack messages, channels, DMs, and search (read-only) | SLACK_TOKEN | | yt-dlp | Download YouTube videos, audio, and subtitles/transcripts | - | | gdoc | Read publicly shared Google Docs | - |

Featured in

• claude-code-tips