codecontext-atlas-cli

CLI tool for CodeContext Hub - Upload and analyze codebases for semantic understanding and AI-powered insights.

Installation

Using npx (Recommended)

npx codecontext-atlas-cli analyze --project-id=<your-project-id> --api-url=<api-url>

Global Installation

npm install -g codecontext-atlas-cli
atlas-cli analyze --project-id=<your-project-id> --api-url=<api-url>

Usage

Analyze Command

Upload and analyze your codebase:

npx codecontext-atlas-cli analyze --project-id=<project-id> --api-url=<api-url> [options]

Options:

• --project-id <id> - Project ID from CodeContext Hub (required)
• --api-url <url> - API endpoint URL (required)
• --path <path> - Path to analyze (default: current directory)
• --dry-run - Show what would be uploaded without actually uploading
• --verbose - Enable verbose logging
• --include <patterns> - Include file patterns (comma-separated)
• --exclude <patterns> - Exclude file patterns (comma-separated)

Upload Command

Upload files without triggering analysis:

npx @codecontext-hub/atlas-cli upload --project-id=<project-id> --api-url=<api-url> [options]

Status Command

Check analysis status:

npx @codecontext-hub/atlas-cli status --project-id=<project-id> --api-url=<api-url>

Examples

Basic Analysis

npx @codecontext-hub/atlas-cli analyze --project-id=abc123 --api-url=https://api.codecontext-hub.com

Dry Run

npx @codecontext-hub/atlas-cli analyze --project-id=abc123 --api-url=https://api.codecontext-hub.com --dry-run

Custom Path with Exclusions

npx @codecontext-hub/atlas-cli analyze \
  --project-id=abc123 \
  --api-url=https://api.codecontext-hub.com \
  --path=./src \
  --exclude="*.test.js,*.spec.ts"

Features

• Smart File Detection: Automatically detects and analyzes code files
• Language Support: Supports JavaScript, TypeScript, Python, Java, C++, and more
• Gitignore Respect: Automatically respects .gitignore patterns
• Progress Monitoring: Real-time progress updates during analysis
• Batch Processing: Efficient batch uploads for large codebases
• Error Handling: Robust error handling and retry logic

Supported File Types

• JavaScript (.js, .jsx, .mjs)
• TypeScript (.ts, .tsx)
• Python (.py)
• Java (.java)
• C/C++ (.c, .cpp, .h, .hpp)
• C# (.cs)
• Go (.go)
• Rust (.rs)
• PHP (.php)
• Ruby (.rb)
• And more...

Requirements

• Node.js 16.0.0 or higher
• Active CodeContext Hub project

License

MIT