Connect Your Project
Link your codebase to Codmir and unlock AI-powered knowledge base integration for intelligent ticket context and development acceleration.
AI-Powered Context
Tickets automatically understand your codebase structure and patterns
Knowledge Base
Auto-generated documentation that stays in sync with your code
Smart Tickets
Ticket details show relevant files, functions, and dependencies
Seamless Integration
Works with your existing workflow and CI/CD pipeline
Prerequisites
- Node.js 18+ installed
- A Codmir account with a project created
- Access to your project's API settings
npm install overseerTip: Installing globally with npm install -g overseer lets you use the CLI from any directory.
# Codmir Configuration
CODMIR_API_KEY=your_api_key_here
CODMIR_PROJECT_ID=proj_xxxxxxxxxxxxSecurity Note
.env file to version control. Add it to your .gitignore.Option A: Interactive Login (Recommended)
# Authenticate with Codmir (opens browser)
overseer loginThen link your project:
# Link your current directory to a Codmir project
overseer linkThe link command will create a .codmir/config.json file in your project root.
# Generate knowledge base from your codebase
overseer generate
# Or use analyze for full codebase analysis
overseer analyzeWhat gets analyzed:
Generated structure:
your-project/
βββ .codmir/
β βββ config.json # Project configuration
β βββ knowledge/
β βββ structure.json # File tree & organization
β βββ dependencies.json # Package dependencies
β βββ patterns.json # Code patterns detected
β βββ tech-stack.json # Technologies used
β βββ context.md # Human-readable summary
βββ .env # Your environment variables
βββ ... your code# Verify your connection
overseer statusYou should see your project name, connection status, and knowledge base sync time.
Automatic Ticket Integration
Once connected, your ticket details will automatically show relevant context from your knowledge base:
- Related files and functions based on ticket content
- Dependency information for affected modules
- Code patterns and conventions to follow
- Historical context from similar tickets
- AI-powered suggestions for implementation
Keep Knowledge Base Updated
# .github/workflows/codmir-sync.yml
name: Sync Codmir Knowledge Base
on:
push:
branches: [main]
jobs:
sync:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
- run: npm install -g overseer
- run: overseer generate
env:
CODMIR_API_KEY: ${{ secrets.CODMIR_API_KEY }}
CODMIR_PROJECT_ID: ${{ secrets.CODMIR_PROJECT_ID }}What's Next?
π§ Troubleshooting
Command not found: overseer
Ensure you've installed globally with npm install -g overseer or use npx overseer instead.
Authentication failed
Check that your CODMIR_API_KEY is valid and hasn't expired.
Project not found
Verify your CODMIR_PROJECT_ID matches the project in your dashboard.