Projects
Projects are the central unit of work in Redstick Agents. Each project has a workspace directory, framework configuration, and associated executions.
Creating a Project#
Click New Project from the dashboard and provide:
- Name — Descriptive project name
- Description (optional) — Brief summary of what the project is about
- Framework — Determines the Docker image, default commands, and agent instructions
The system generates a URL-friendly slug from the name (3-63 characters, lowercase letters, numbers, and hyphens). The slug is immutable after creation.
Permission required: project:create
Supported Frameworks#
15 frameworks across 5 runtime categories:
| Framework | Label | Port | Default Command | Image |
|---|---|---|---|---|
nextjs | Next.js | 3000 | npx next dev -p 3000 -H 0.0.0.0 | node |
vite | Vite | 5173 | npx vite --host 0.0.0.0 --port 5173 | node |
react | React | 3000 | npx react-scripts start | node |
vuejs | Vue.js | 5173 | npx vite --host 0.0.0.0 --port 5173 | node |
node | Node.js | 3000 | npm start | node |
expressjs | Express.js | 3000 | node server.js | node |
python | Python | 8000 | python main.py | python |
flask | Flask | 5000 | flask run --host 0.0.0.0 --port 5000 | python |
fastapi | FastAPI | 8000 | uvicorn main:app --host 0.0.0.0 --port 8000 | python |
go | Go | 8080 | go run . | go |
fiber | Fiber | 3000 | go run . | go |
gin | Gin | 8080 | go run . | go |
ruby | Ruby | 8080 | ruby main.rb | ruby |
rails | Rails | 3000 | bin/rails server -b 0.0.0.0 -p 3000 | ruby |
none | None | 80 | (Caddy file server) | sidecar |
Each framework provides specific agent instructions that guide the AI on conventions, entry points, and best practices.
Runtime Versions#
Projects can select a specific runtime version for their framework's language. If not specified, the default version is used.
| Language | Supported Versions | Default |
|---|---|---|
| Node.js | 18, 20, 22 | 20 |
| Python | 3.11, 3.12, 3.13 | 3.12 |
| Go | 1.21, 1.22, 1.23, 1.24, 1.25, 1.26 | 1.22 |
| Ruby | 3.2, 3.3, 3.4 | 3.3 |
The none framework does not support runtime version selection.
Dashboard#
The project dashboard shows all projects with their status:
- Active execution count per project
- Pin/unpin projects for quick access in the sidebar
- Archive/unarchive — Hide projects without deleting them
- Filter to include or exclude archived projects
Project Settings#
Access settings via the gear icon on any project. Configurable fields:
- Name and description
- Framework (can be changed)
- Install command — Custom dependency installation command
- Delete — Permanently removes the project and its workspace (requires
project:deletepermission)
Permission required: project:settings
Project Context (CLAUDE.md)#
Each project has a context editor where you configure the CLAUDE.md file that gets injected into every agent execution. Use this to:
- Set project-specific coding conventions
- Define architecture decisions
- Specify allowed tool paths
- Provide domain context
The context editor auto-saves changes.
Archiving#
Archive projects you're not actively working on. Archived projects:
- Don't appear in the default dashboard view
- Retain all data and execution history
- Can be unarchived at any time
- Cannot start new executions while archived
Archival guards:
- Cannot archive a project while executions are running or pending — stop or wait for them to complete first
- Any queued executions are automatically cancelled when the project is archived
- If a queued execution is dequeued after archival (race condition), it is cancelled instead of started