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#
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.
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#
API Integration#
Create Project#
List Projects#
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