|
1 | | -# AI Agents Sandbox 🤖🔒 |
| 1 | +# [ARCHIVED] AI Agents Sandbox |
2 | 2 |
|
3 | | -Secure Docker environments for AI-assisted coding with network isolation. |
4 | | - |
5 | | -## Installation |
6 | | - |
7 | | -```bash |
8 | | -git clone https://github.com/alexsteeel/ai-agents-sandbox.git |
9 | | -cd ai-agents-sandbox |
10 | | -pip install -e . |
11 | | -``` |
12 | | - |
13 | | -## Quick Start |
14 | | - |
15 | | -```bash |
16 | | -# 1. One-time setup (builds images, creates group) |
17 | | -ai-sbx init global |
18 | | - |
19 | | -# 2. Initialize your project |
20 | | -cd /path/to/your/project |
21 | | -ai-sbx init project |
22 | | - |
23 | | -# 3. Create task worktree (automatically opens IDE) |
24 | | -ai-sbx worktree create "implement user authentication" |
25 | | - |
26 | | -# Work on your task... |
27 | | - |
28 | | -# 4. Clean up when done |
29 | | -ai-sbx worktree remove |
30 | | -``` |
31 | | - |
32 | | -## Features |
33 | | - |
34 | | -- **Security:** Non-root containers, network isolation, proxy filtering |
35 | | -- **Per-task isolation:** Each task in its own git worktree |
36 | | -- **AI-ready:** Works with Claude Code, Codex, and other AI assistants |
37 | | -- **Auto IDE launch:** `worktree create` opens your preferred IDE automatically |
38 | | -- **Docker caching:** Built-in registry proxy for fast image pulls |
39 | | -- **Multiple environments:** Base, .NET, Go variants |
40 | | - |
41 | | -## Commands |
42 | | - |
43 | | -```bash |
44 | | -ai-sbx init global # One-time system setup |
45 | | -ai-sbx init project # Setup project with devcontainer |
46 | | -ai-sbx worktree create # Create task workspace (opens IDE) |
47 | | -ai-sbx worktree list # List workspaces |
48 | | -ai-sbx worktree remove # Remove workspace |
49 | | -ai-sbx notify # Watch for container notifications (run on host) |
50 | | -ai-sbx doctor --fix # Fix common issues |
51 | | -``` |
52 | | - |
53 | | -## Documentation |
54 | | - |
55 | | -- [Architecture — Components & Networks](docs/ARCHITECTURE.md) |
56 | | -- [Full documentation](docs/) |
57 | | - |
58 | | -## Configuration |
59 | | - |
60 | | -Run `ai-sbx init project` again to reconfigure: |
61 | | -- Whitelist domains |
62 | | -- Upstream proxy |
63 | | -- Custom registries |
64 | | -- Claude settings inclusion |
65 | | - |
66 | | -Or manually edit `.devcontainer/ai-sbx.yaml` and run `ai-sbx init update` |
67 | | - |
68 | | -## IDE Setup (if opening manually) |
69 | | - |
70 | | -**VS Code:** Open folder → "Reopen in Container" |
71 | | - |
72 | | -**PyCharm (DevContainer setup):** |
73 | | -When you open the project, it should automatically suggest loading in devcontainer. Alternative method: |
74 | | -- Right-click on .devcontainer.json file > Dev Containers > Create Devcontainer and mount sources > PyCharm |
75 | | -For other JetBrains IDEs, the process is similar |
76 | | - |
77 | | -**Claude Code:** `claude --dangerously-skip-permissions` |
78 | | - |
79 | | -## License |
80 | | - |
81 | | -MIT |
| 3 | +> **This repository has been migrated to [github.com/alexsteeel/ralph](https://github.com/alexsteeel/ralph) and is no longer maintained.** |
| 4 | +> |
| 5 | +> All sandbox tooling has moved into the `ralph/sandbox/` directory of the ralph monorepo. |
0 commit comments