Karamelmar 09ff27be92 Add Context Studio Wizard — project scaffolding CLI

- wizard.sh: interactive bash wizard that scaffolds new CS projects
- lib/: utils, core install, project structure, workflow generation
- templates/: Dockerfile, devcontainer.json, agent presets (minimal/standard), system.json, roles, hook rules
- README: setup, usage, mobility workflow

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-09 11:49:04 +01:00

2.8 KiB

Raw Blame History

Context Studio Wizard

Scaffold a fully configured multi-agent AI development environment in seconds.

What it does

One command. One conversation. A complete project drops out:

~/.context-studio/core/          ← installed once, shared globally

~/projects/my-project/
├── .devcontainer/               ← Node 22 · Rust · Claude Code · Electron deps
├── workflow/                    ← agents, roles, A2A config, project docs
└── src/                         ← your code

Open in devcontainer → start Context Studio → talk to your agent team.

Prerequisites

Tool	Purpose
`git`	Clone repos
`docker` or `podman`	Run devcontainer
SSH key → `github.com`	Access context-studio-core
`ANTHROPIC_API_KEY`	Claude agents

Usage

./wizard.sh

The wizard guides you through:

Core setup — clones context-studio-core to ~/.context-studio/core/ (once)
Project name & location
Workflow — generate from scratch or clone an existing repo
Agent preset (if generating)

Preset Agents

minimal coordinator · 2× coder · researcher · tester

standard 2× coordinator · 3× coder · 2× researcher · tester · reviewer
Done — git repo initialized, devcontainer ready

Preset	Agents
`minimal`	coordinator · 2× coder · researcher · tester
`standard`	2× coordinator · 3× coder · 2× researcher · tester · reviewer

Open the project

VS Code

code ~/projects/my-project   # → "Reopen in Container"

CLI

cd ~/projects/my-project
docker build -t my-project .devcontainer/
docker run -it --rm \
  -v "$(pwd)":/workspace \
  -v "$HOME/.context-studio/core":/opt/context-studio/core \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  my-project bash

Start Context Studio (inside container)

node $CS_CORE_DIR/core/start.js                    # Electron UI
node $CS_CORE_DIR/core/start.js --ui-mode=headless # servers only

Mobility

Commit your project. On any machine:

git clone <your-project-repo>
cd my-project
code .   # done

Core is re-cloned automatically on first run. Only ANTHROPIC_API_KEY is needed on the host.

Repository layout

wizard.sh               ← entry point
lib/
  utils.sh              ← prompts, colors, helpers
  core.sh               ← global core install/update
  project.sh            ← devcontainer + project scaffold
  workflow.sh           ← generate or clone workflow config
templates/
  Dockerfile            ← Node 22 + Rust + build tools + Claude Code
  devcontainer.json     ← mounts, env vars, VS Code extensions
  agents-minimal.json   ← 5-agent preset
  agents-standard.json  ← 9-agent preset
  system.json           ← A2A server defaults
  roles/                ← coordinator, coder, researcher, tester, reviewer
  hooks/rules/          ← per-role tool restrictions

2.8 KiB Raw Blame History Unescape Escape