codecontext repos
Manage multiple repositories from one place
PROThe repos
command lets you manage documentation across multiple repositories. Switch contexts, track health scores, and maintain consistent documentation standards across all your projects.
Central Management
View and manage all your repositories from one command
Quick Switching
Switch between repository contexts instantly
Global Overview
Track documentation health across all projects
$ codecontext repos list
Interactive Demo
Subcommands
list
Show all managed repositories with health scores
$ codecontext repos list
add
Add a repository to manage
$ codecontext repos add ~/projects/new-repo
switch
Switch to a different repository context
$ codecontext repos switch backend-api
update-all
Update documentation in all repositories
$ codecontext repos update-all
Managing Multiple Repositories
Typical Workflow
Add repositories
codecontext repos add ~/projects/frontend
Check health across all repos
codecontext repos list
Switch to work on specific repo
codecontext repos switch backend-api
Update all documentation
codecontext repos update-all
Key Features
Quick Context Switching
Switch between repositories without changing directories:
- • Work on frontend, switch to backend instantly
- • Maintain separate contexts and configurations
- • Remember last position in each repo
Bulk Operations
Perform operations across all repositories:
- • Update documentation in all repos
- • Check health scores globally
- • Apply consistent settings everywhere
Health Monitoring
Track documentation quality across projects:
- • See health scores at a glance
- • Identify repos needing attention
- • Track improvement over time
Team Collaboration
Share repository lists with your team:
- • Export repository configurations
- • Standardize team workflows
- • Ensure consistent documentation
Configuration
Repository lists are stored in ~/.codecontext/repos.json
:
{ "repositories": [ { "name": "frontend-app", "path": "/Users/john/projects/frontend-app", "lastAccessed": "2024-01-15T10:30:00Z", "healthScore": 92, "favorite": false }, { "name": "backend-api", "path": "/Users/john/projects/backend-api", "lastAccessed": "2024-01-14T15:45:00Z", "healthScore": 78, "favorite": true } ], "currentRepo": "backend-api" }
Tips & Tricks
Star your favorites
Use codecontext repos star [name]
to mark frequently-used repos.
Organize by project
Group related repositories together using consistent naming: project-frontend, project-backend, project-mobile.
Regular health checks
Run codecontext repos list --sort health
weekly to prioritize documentation improvements.
Pro Feature
Available on Pro Plan
Multi-repository management is a PRO feature ($29/month) that includes:
- • Unlimited repository management
- • Bulk documentation updates
- • Cross-repository health tracking
- • Team repository sharing
- • Priority context switching
See Also
- codecontext workspace - Create multi-repo workspaces
- codecontext health - Check documentation health
- Team Workflows Guide - Best practices for teams