Project Management
Create, configure, and monitor your Bootspring projects.
Overview
Projects are the primary organizational unit in Bootspring. Each project:
- Has its own context (CLAUDE.md)
- Tracks separate usage metrics
- Can have dedicated API keys
- Maintains independent configuration
Project List
The Projects page shows all your projects:
┌─────────────────────────────────────────────────────────────────────┐
│ Projects [+ New Project] │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ 🚀 My SaaS App Active Pro │ │
│ │ github.com/user/my-saas-app │ │
│ │ Last active: 2 minutes ago │ │
│ │ API Calls: 3,420 │ Agents: 156 │ Context: Synced │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ 📱 Mobile App Active Pro │ │
│ │ github.com/user/mobile-app │ │
│ │ Last active: 1 hour ago │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ 🔬 Experiment Inactive Free │ │
│ │ Local project │ │
│ │ Last active: 3 days ago │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘
Creating a Project
From Dashboard
- Click New Project
- Fill in project details:
- Name - Display name
- Repository - GitHub/GitLab URL (optional)
- Description - Brief description
- Stack - Tech stack selection
- Click Create Project
From CLI
Loading code block...
Project Details
Click a project to view its detail page:
Overview Tab
- Project status and health
- Recent activity log
- Quick stats (API calls, agents, skills)
- Active devices
Configuration Tab
- Project settings
- Context configuration
- Agent preferences
- Skill settings
- Quality gate configuration
API Keys Tab
- Project-specific API keys
- Key permissions and scopes
- Usage per key
Usage Tab
- Detailed usage metrics
- Historical trends
- Cost attribution
Settings Tab
- Rename project
- Transfer ownership
- Archive/delete project
Project Configuration
General Settings
| Setting | Description |
|---|---|
| Name | Project display name |
| Slug | URL-friendly identifier |
| Description | Brief description |
| Repository | Linked repository URL |
| Visibility | Public or private |
Context Settings
| Setting | Description |
|---|---|
| Context File | Path to CLAUDE.md |
| Auto-regenerate | Regenerate on changes |
| Include Patterns | Files to include in context |
| Exclude Patterns | Files to exclude |
Agent Settings
| Setting | Description |
|---|---|
| Enabled Agents | Which agents are available |
| Default Agent | Agent for general queries |
| Custom Instructions | Per-agent customization |
Quality Settings
| Setting | Description |
|---|---|
| Pre-commit Checks | Enabled checks |
| Pre-push Checks | Enabled checks |
| Minimum Coverage | Test coverage threshold |
| Lint Rules | Custom lint configuration |
Project Status
| Status | Description |
|---|---|
| Active | Recent activity within 24 hours |
| Inactive | No activity in 7+ days |
| Archived | Manually archived, read-only |
| Error | Configuration or sync issues |
Project Actions
Archive Project
Archiving hides a project from active views but preserves all data. When you archive a project:
- API keys are unlinked, not deleted — your keys remain usable for other projects
- Usage data is retained for billing and analytics history
- Audit logs and presence history are retained
- The project no longer counts against your project limit
- You can restore an archived project at any time from the projects list
To confirm archiving, you must type the project name in the confirmation dialog.
Loading code block...
Transfer Ownership
Transfer to another team member (Team/Enterprise plans):
- Go to Settings > Transfer Ownership
- Select a current team member as the new owner
- The transfer takes effect immediately
Only the current owner can transfer ownership. The new owner inherits all project permissions.
Team Invitations
Invite collaborators to your project:
- Go to Project Settings > Team Members
- Click Invite Member and enter their email
- Choose a role: Admin, Member, or Viewer
- The invitee receives an email with a link valid for 7 days
Invitation behavior:
- Duplicate invitations to the same email are rejected
- Invitations to existing project members are rejected
- Invitees must have a verified email to accept
- Expired invitations can be resent from the Pending Invitations panel
- Owners and admins can revoke pending invitations
| Role | Permissions |
|---|---|
| Owner | Full control, transfer, archive |
| Admin | Manage members, settings, keys |
| Member | View project, use linked keys |
| Viewer | Read-only access |
Project Limits
| Plan | Max Projects |
|---|---|
| Free | 1 |
| Pro | 10 |
| Team | 50 |
| Enterprise | Unlimited |
CLI Commands
Loading code block...
API Integration
Create Project
Loading code block...
List Projects
Loading code block...
See Projects API for full reference.
Best Practices
1. One Project Per Repository
Map projects 1:1 with repositories for clean separation.
2. Use Descriptive Names
Choose names that identify the project at a glance.
3. Configure Context Properly
Set appropriate include/exclude patterns for accurate context.
4. Monitor Usage
Check usage regularly to stay within plan limits.
5. Archive Unused Projects
Archive instead of deleting to preserve history.
Related
- API Keys - Project API keys
- Usage - Usage tracking
- Projects API - API reference