Projects

Projects are the core unit of work in Stoa. A project represents a codebase or set of files that you want to collaborate on, track topics for, and build provenance history.

Creating a Web Project

Create a project directly in the browser:

1. Go to the Projects page from the left navigation and click "New Project".
2. Enter a project name (required, max 100 characters).
3. Optionally add a description (max 500 characters).
4. The project is automatically shared with all members of the team.
5. Click Create.

Registering a CLI Project

Bring a local codebase into Stoa:

# Navigate to your project
cd /path/to/your/project

# Initialize tracking
stoa init

# Register with the web platform
stoa web register

stoa web register is org-first: it always creates projects shared with a team. If you belong to multiple teams, use --org to specify which one. If you only have one team, it's selected automatically.

After registration:

• Files sync to the web platform
• You can view and edit files in the browser
• All team members can access the project immediately

Managing CLI Projects

# List all registered projects
stoa web projects list

# Show project details
stoa web projects show <project-id>

# Share with a team
stoa web projects share <project-id> <org-id>

# Remove sharing
stoa web projects unshare <project-id>

# Unregister a project
stoa web projects delete <project-id>

Projects Table

On the team's Projects page, projects are displayed in a sortable, filterable table:

Click any column header to sort. Click again to reverse the sort direction.

Filtering

Use the filter bar above the table to narrow results:

• Search by project name
• Source dropdown to show only Web, CLI, or GitHub projects
• Space multi-select to filter by Space
• Owner multi-select to filter by creator

Active filters appear as chips below the filter bar. Click a chip to remove it, or use Clear all to reset.

Project Actions

• Open to navigate to the project workspace
• Space dropdown to switch between Spaces (if the project belongs to multiple)
• Delete to remove the project

Sharing Projects with a Team

When a project is shared with a team:

• All team members can access the project
• The project appears on the team dashboard
• It can be added to Spaces
• Sessions can be created for collaboration

You can share a project:

• At creation time (automatically shared with the team)
• Via CLI: stoa web projects share <project-id> <org-id>

What's Next