@codmir/cli

codmir

Official Codmir CLI - AI-powered autonomous agent for developers.

Features

• 🤖 AI Assistant - Interactive AI-powered coding assistant in your terminal
• 🔍 Codebase Analysis - Understand and navigate your codebase with AI
• ⚡ Intelligent Automation - Automate repetitive development tasks
• 🎯 Context-Aware - Understands your project structure and dependencies
• 🔗 Cloud Sync - Sync tasks and context with the Codmir platform

Installation

# Install globally
npm install -g codmir

# Or use with npx
npx codmir

Quick Start

# Login to your Codmir account
codmir login

# Start an interactive AI session
codmir

# Ask a question about your codebase
codmir "How is authentication implemented?"

# Analyze your project
codmir analyze

Commands

Interactive Mode

# Start interactive AI assistant
codmir

# You can then chat naturally:
# > How do I add a new API endpoint?
# > Explain the database schema
# > Help me fix this error: [paste error]

Project Commands

# Link current directory to a Codmir project
codmir link

# Show project status
codmir status

# Analyze codebase and generate insights
codmir analyze

Task Commands

# Create a new task
codmir task create "Implement user authentication"

# List tasks
codmir task list

# Get task details
codmir task show <task-id>

Authentication

# Login to Codmir
codmir login

# Show current user
codmir whoami

# Logout
codmir logout

Cloud Sync

# Sync local context to cloud
codmir sync

# Push local changes
codmir sync push

# Pull remote changes
codmir sync pull

Configuration

The CLI uses the following environment variables:

Variable	Description	Default
CODMIR_API_KEY	API key for authentication	-
CODMIR_API_URL	Custom API endpoint	https://codmir.com/api
CODMIR_PROJECT_ID	Default project ID	-

You can also create a .codmir config file in your project root:

{
  "projectId": "your-project-id",
  "organization": "your-org-slug"
}

Usage Examples

Code Review

# Review staged changes
codmir "Review my staged changes for potential issues"

# Review a specific file
codmir "Review src/auth/login.ts for security issues"

Debugging Help

# Get help with an error
codmir "I'm getting this error: TypeError: Cannot read property 'id' of undefined"

# Explain code behavior
codmir "Why is this function returning null?"

Code Generation

# Generate code
codmir "Write a function to validate email addresses"

# Generate tests
codmir "Write unit tests for the UserService class"

Documentation

# Generate documentation
codmir "Document the API endpoints in src/routes/"

# Explain code
codmir "Explain how the payment flow works"

Programmatic Usage

You can also import the CLI functionality in your Node.js projects:

import { createContext } from 'codmir/context';
import { syncToCloud } from 'codmir/sync';

// Create a context for the current directory
const context = await createContext({
  rootDir: process.cwd(),
  includeGitHistory: true,
});

// Sync to cloud
await syncToCloud(context, {
  projectId: 'your-project-id',
});

Requirements

• Node.js >= 18.0.0
• npm, pnpm, or yarn

Related Packages

• @codmir/sdk - TypeScript/JavaScript SDK for the Codmir API
• @codmir/types - Shared type definitions

Support

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discord Community

License

MIT