Bootspring
HomeGet Started

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#

  1. Click New Project
  2. Fill in project details:
    • Name - Display name
    • Repository - GitHub/GitLab URL (optional)
    • Description - Brief description
    • Stack - Tech stack selection
  3. Click Create Project

From CLI#

# Create project from current directory bootspring init # Create with specific details bootspring init --name "My App" --stack nextjs,prisma

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#

SettingDescription
NameProject display name
SlugURL-friendly identifier
DescriptionBrief description
RepositoryLinked repository URL
VisibilityPublic or private

Context Settings#

SettingDescription
Context FilePath to CLAUDE.md
Auto-regenerateRegenerate on changes
Include PatternsFiles to include in context
Exclude PatternsFiles to exclude

Agent Settings#

SettingDescription
Enabled AgentsWhich agents are available
Default AgentAgent for general queries
Custom InstructionsPer-agent customization

Quality Settings#

SettingDescription
Pre-commit ChecksEnabled checks
Pre-push ChecksEnabled checks
Minimum CoverageTest coverage threshold
Lint RulesCustom lint configuration

Project Status#

StatusDescription
ActiveRecent activity within 24 hours
InactiveNo activity in 7+ days
ArchivedManually archived, read-only
ErrorConfiguration or sync issues

Project Actions#

Archive Project#

Archived projects:

  • Remain accessible in read-only mode
  • Don't count against project limits
  • Can be restored anytime
# Archive via CLI bootspring project archive my-project

Delete Project#

Deleting a project:

  • Removes all project data
  • Revokes associated API keys
  • Cannot be undone

Transfer Ownership#

Transfer to another user (Team/Enterprise):

  1. Go to Settings > Transfer
  2. Enter new owner's email
  3. New owner must accept

Project Limits#

PlanMax Projects
Free1
Pro10
Team50
EnterpriseUnlimited

CLI Commands#

1# List projects 2bootspring project list 3 4# Show project details 5bootspring project show my-project 6 7# Update project 8bootspring project update my-project --name "New Name" 9 10# Archive project 11bootspring project archive my-project 12 13# Delete project 14bootspring project delete my-project --confirm

API Integration#

Create Project#

1curl -X POST https://api.bootspring.dev/v1/projects \ 2 -H "Authorization: Bearer bs_xxx" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "name": "My New Project", 6 "repository": "https://github.com/user/repo" 7 }'

List Projects#

curl https://api.bootspring.dev/v1/projects \ -H "Authorization: Bearer bs_xxx"

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#