Projects

Isolated git worktrees that enable parallel development on different branches without conflicts. Perfect for AI-assisted coding workflows.

What is a Project?

A Project in Rizome is an in-memory git worktree that provides an isolated copy of a specific branch. This allows multiple developers (and AI assistants) to work on different features simultaneously without interfering with each other.

Branch Isolation

Each project operates on its own branch, preventing conflicts and enabling parallel development.

In-Memory Worktree

Fast, ephemeral copies of your repository that can be quickly created and destroyed as needed.

Why Git Worktrees?

Traditional git workflows require switching branches, which can be disruptive for AI coding assistants that need context. Git worktrees solve this by allowing multiple checkouts of the same repository simultaneously.

No Context Loss

AI assistants maintain full context without branch switching

Parallel Work

Multiple features developed simultaneously

Clean Isolation

No merge conflicts or dirty working directories

Creating Projects

From Existing Branch

Create a project from an existing branch in your repository:

API Method
curl -X POST https://api.rizome.dev/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d {{
"name": "feature-auth",
"repository_id": "repo_123",
"branch": "feature/authentication"
}
CLI Method
rizome project create feature-auth --branch feature/authentication

From New Branch

Create a project with a new branch based on main:

API Method
curl -X POST https://api.rizome.dev/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d {{
"name": "feature-payments",
"repository_id": "repo_123",
"branch": "feature/payments",
"base_branch": "main"
}
CLI Method
rizome project create feature-payments --new-branch --base main

Project Management

List Projects

View all projects in your workspace:

GET /v1/projects
rizome project list
Response:
{
  "projects": [
    {
      "id": "proj_123",
      "name": "feature-auth",
      "branch": "feature/authentication",
      "status": "active",
      "created_at": "2025-09-19T10:30:00Z"
    }
  ]
}

Project Status

Projects can be in different states:

Active
Ready for development
Provisioning
Setting up worktree
Suspended
Temporarily paused
Error
Failed to provision

AI Assistant Integration

Why Projects Work Great with AI

AI coding assistants like Claude Code, Cursor, and Windsurf heavily recommend git worktrees because they:

✓

Maintain Context

AI can keep full project context without branch switching disruptions

✓

Isolated Sandboxes

Each project can have dedicated execution environments

✓

Parallel Development

Multiple AI assistants can work on different features simultaneously

✓

Clean Experiments

Try different approaches without affecting main development

Best Practices

Naming Conventions

  • • Use descriptive project names: feature-user-auth
  • • Include issue numbers: issue-123-fix-login
  • • Indicate project type: experiment-new-ui
  • • Use kebab-case for consistency

Lifecycle Management

  • • Clean up completed projects regularly
  • • Merge successful features back to main
  • • Archive experimental projects for reference
  • • Set up automated cleanup policies

Common Workflows

Feature Development

1. Create project from new branch: rizome project create feature-payments --new-branch
2. Create sandbox for the project: rizome sandbox create --project feature-payments
3. Connect your AI assistant to the sandbox
4. Develop the feature with AI assistance
5. Test and commit changes
6. Create pull request and merge
7. Clean up project and sandbox

Bug Fix

1. Create project from main branch: rizome project create hotfix-auth --branch main
2. Create new branch for the fix: git checkout -b hotfix/auth-validation
3. Launch sandbox and connect AI assistant
4. Identify and fix the issue
5. Test the fix thoroughly
6. Create pull request for review
7. Deploy and monitor

Next Steps

Learn About Sandboxes

Discover how to create execution environments for your projects and connect AI coding assistants.

Read more

Try the Quick Start

Follow our step-by-step guide to create your first project and get hands-on experience.

Get started

API Reference

Complete API documentation for project management endpoints.

View API Reference