ykdojo/safeclaw

ykdojo profile

Latest recorded source activity: February 19, 2026 at 08:09

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 3

GitHub stars: 184
GitHub forks: 20

Repository README

Repository README source: README.md

Read the source README

Expand full README

# SafeClaw The easiest way to run multiple Claude Code sessions, each in its own container, with a dashboard to manage them all. Quick setup with battle-tested [sensible defaults](#sensible-defaults) and [skills](#skills). https://github.com/user-attachments/assets/e282ed8f-3ec9-4a9e-aa9e-4bc84f9281e9 See [architecture.md](architecture.md) for design details. ## Why a container? - **Isolated** - Claude Code runs with bypass permissions, but can't touch your host machine. - **Lightweight** - Spin up, stop, or delete sessions in seconds. Much faster than a full VM. - **Portable** - Works on any machine with Docker. Same environment everywhere. This lets you run Claude Code with `--dangerously-skip-permissions` safely and fast. ## One session per container Each Claude Code session runs in its own container. Spin up as many as you need - they're isolated from each other and start in seconds. Run different research tasks, projects, or experiments in parallel without interference. Conversation history is automatically stored on your host machine via a volume mount. ## Quickstart ```bash # Build image (once, or after changes) ./scripts/build.sh # Start container and web terminal ./scripts/run.sh # To mount a local project (host_path:container_path) ./scripts/run.sh -v ~/myproject:/home/sclaw/myproject # Run multiple sessions with -s ./scripts/run.sh -s work # safeclaw-work on next available port ./scripts/run.sh -s research # safeclaw-research on next available port ``` On first run, `run.sh` will prompt you to set up authentication tokens. It then starts a web terminal at http://localhost:7681 and opens it in your browser. ## Dashboard ![Dashboard showing multiple Claude Code sessions running in parallel](assets/dashboard.png) Manage all sessions from a web dashboard: ```bash 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-slack.sh` - Add Slack read access ## What's included - Ubuntu 24.04 - Node.js 24 (LTS) - Claude Code 2.1.283 - GitHub CLI with auto-configured git user - Playwright MCP with Chromium - Slack read-only skill and tool (optional - requires token) - [DX plugin](https://github.com/ykdojo/claude-code-tips#tip-44-install-the-dx-plugin), [custom status line](https://github.com/ykdojo/claude-code-tips#tip-0-customize-your-status-line), [shell aliases](#aliases) - ttyd web terminal + tmux ## Sensible defaults - Claude Code version pinned (currently 2.1.283) - `autoCompactEnabled: false` - prevents automatic context compaction - `promptSuggestionEnabled: false` - disables prompt suggestions - `--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 | | `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-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` | ## 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-slack` | `./scripts/setup-slack.sh` | | `npm run manage-env` | `node scripts/manage-env.js` | ## Skills Defined in `setup/skills/`. | Skill | Description | Requires | |-------|-------------|----------| | 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](https://github.com/ykdojo/claude-code-tips)

Loading the repository README…

Skills in this repository

Office Clerks, General

1 occupation categories · 100% classified

skill

occupation

description

updated

gdoc

Office Clerks, General

Read publicly shared Google Docs using curl to download into a file.

2026-02-19

yt-dlp

Office Clerks, General

Download YouTube videos, audio, and subtitles/transcripts using yt-dlp.

2026-02-09

slack

Office Clerks, General

Read Slack messages, channels, DMs, and search. Read-only access to your Slack workspace.

2026-02-03

Showing 3 of 3 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/ykdojo/safeclaw.