codecontext workspace

Manage multi-repository documentation

PRO

The workspace command enables multi-repository documentation management. Link related repositories together to get cross-repo intelligence, unified documentation, and pattern sharing across your entire codebase.

Cross-Repo Intelligence

Ask questions and get guidance across all linked repositories

Virtual Paths

Reference files with @alias syntax across repositories

Unified Patterns

Share patterns and conventions across all your projects

$ codecontext workspace add ../backend --alias api

Interactive Demo

Terminal

Subcommands

add

Add a repository to the workspace

$ codecontext workspace add ../backend --alias api

list

Show all repositories in the workspace

$ codecontext workspace list

sync

Update workspace context and patterns

$ codecontext workspace sync

Virtual Path System

Once repositories are added to a workspace, you can reference files using virtual paths:

Example Workspace

@frontend → ./frontend-app
@api → ../backend-api
@shared → ../shared-components
@mobile → ~/projects/mobile-app

Using Virtual Paths

codecontext how "implement auth like @api/src/auth/login.js"
codecontext learn "how does @shared/Button work with @mobile?"
codecontext review --compare @api/patterns

Common Use Cases

Microservices Architecture

Link all your microservices to understand data flow and dependencies:

  • • User service, payment service, notification service
  • • Shared libraries and utilities
  • • API gateway and routing logic

Monorepo Management

Create workspaces within your monorepo for better organization:

  • • Frontend apps and backend services
  • • Shared packages and tools
  • • Documentation and configs

Full-Stack Projects

Connect frontend and backend for complete understanding:

  • • React/Vue/Angular frontend
  • • Node.js/Python/Go backend
  • • Mobile apps (React Native/Flutter)

Library Ecosystem

Manage related libraries and their consumers:

  • • Core library and plugins
  • • Example applications
  • • Testing utilities

Key Benefits

Cross-Repository Intelligence

Ask questions that span multiple repositories. "How does authentication in @api integrate with @frontend?"

Pattern Consistency

Ensure consistent patterns across all repositories. Review commands check against workspace-wide patterns.

Unified Documentation

Generate documentation that understands relationships between repositories and services.

Workspace Configuration

Workspaces are configured in .codecontext/workspace.json:

{
  "name": "my-project-workspace",
  "repositories": [
    {
      "path": "./",
      "alias": "frontend",
      "description": "React frontend application"
    },
    {
      "path": "../backend",
      "alias": "api",
      "description": "Node.js API server"
    },
    {
      "path": "../shared-libs",
      "alias": "shared",
      "description": "Shared utilities and components"
    }
  ],
  "patterns": {
    "merge": true,
    "precedence": ["api", "frontend", "shared"]
  }
}

Pro Feature

Available on Pro Plan

Workspace management is a PRO feature ($29/month) that includes:

  • • Unlimited repository connections
  • • Cross-repo intelligence and search
  • • Unified pattern analysis
  • • Team workspace sharing
  • • Advanced virtual path system

See Also

);