didericis
0c1740ca99
test / run tests/run_tests.py (push) Successful in 23s
Drop docs/JOURNAL.md and .claude/skills/init-entry/, and update CLAUDE.md, docs/INDEX.md, and claude-bottle.example.json so nothing points at them anymore. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# claude-bottle
|
|
|
|
## What this is
|
|
|
|
claude-bottle spins up an isolated container for running Claude Code with a
|
|
curated set of skills and env vars. The point is to run Claude with broad
|
|
permissions inside a sandbox, so a misbehaving agent cannot reach the host.
|
|
Bash scripts orchestrate the container lifecycle and the copying of skills
|
|
and env vars into it.
|
|
|
|
## Goals
|
|
|
|
- Minimize risk of running claude with full permissions
|
|
- Allow me to easily spin up agent tasks in parallel
|
|
- Create isolated, well defined, easily updated, shareable agents
|
|
|
|
## Non-goals
|
|
|
|
- Communicating between agents directly
|
|
- Self hosted VMs (v1 uses local Docker containers, not VMs)
|
|
- Advanced agent auditing (lean on git history for auditing)
|
|
|
|
## Repository layout
|
|
|
|
- `README.md` — short public-facing description.
|
|
- `CLAUDE.md` — this file, orientation for future Claude sessions.
|
|
- `.gitignore` — OS junk.
|
|
- `claude-bottle.json` — manifest of named agents (env / skills / prompt
|
|
per agent), consumed by `cli.py`. See "Manifest" under
|
|
"Intended design".
|
|
- `docs/INDEX.md` — pointer to the research notes.
|
|
- `docs/prds/` — product requirement docs.
|
|
- `docs/research/` — research notes (empty for now, kept tracked via `.gitkeep`).
|
|
|
|
## Conventions
|
|
|
|
- Product requirement docs live in `docs/prds/`.
|
|
- Research notes live in `docs/research/`.
|
|
- Low dependencies by default. The project is bash-first; ask before adding new
|
|
tools, runtimes, or package managers.
|
|
- Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/):
|
|
`<type>[(scope)][!]: <description>`, where `<type>` is one of `feat`, `fix`,
|
|
`docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`.
|
|
A `commit-msg` hook in `.githooks/` enforces this. Activate it once per clone
|
|
with `git config core.hooksPath .githooks`.
|
|
|
|
## When you're unsure
|
|
|
|
Ask. Default to drafting in chat over editing files when the request is ambiguous.
|