Olane CLI

Command-line interface for the Olane Network — interact with the Copass knowledge graph, ingest code and documentation, and query your project's ontology.

Installation

npm (recommended)

npm install -g @olane/o-cli

Homebrew

brew tap olane-labs/tap
brew install olane

From source

git clone https://github.com/olane-labs/o-cli.git
cd o-cli
pnpm install
pnpm build

Requires Node.js >= 20.0.0.

Quick start

# Authenticate
olane login

# Initialize your project
olane setup

# Index your codebase
olane index --mode full

# Start continuous incremental indexing in the foreground
olane watch

# Query the knowledge graph
olane copass question "How does authentication work in this project?"

# Search for entities
olane search "UserService"

Commands

Authentication

| Command | Description | |---------|-------------| | olane login | Sign in with email (OTP verification) | | olane logout | Clear stored auth tokens |

Project

| Command | Description | |---------|-------------| | olane setup | Interactive project initialization | | olane status | Check indexing status and project health | | olane index --mode <full\|incremental> | Index project for ontology enrichment | | olane watch | Watch the project for continuous incremental indexing | | olane watch status | Check watch service health and last sync | | olane watch install-service | Install and start the background watch service | | olane watch uninstall-service | Remove the background watch service |

Copass (Knowledge Graph)

| Command | Description | |---------|-------------| | olane copass question <question> | Natural language Q&A against your ontology | | olane copass context <canonical-id> | Get LLM-generated context summary for an entity | | olane copass score <query> | Score knowledge graph coverage for an entity name, UUID, or free text |

Search & Ingestion

| Command | Description | |---------|-------------| | olane search <query> | Search ontology by name or description | | olane ingest code [file] | Ingest source code for entity extraction | | olane ingest text [file] | Ingest text or documentation |

API Keys

| Command | Description | |---------|-------------| | olane api-key create | Generate a long-lived API key | | olane api-key list | List active API keys | | olane api-key revoke <key-id> | Revoke an API key |

Configuration

| Command | Description | |---------|-------------| | olane config set <key> <value> | Set a config value | | olane config get <key> | Get a config value | | olane config list | List all config values |

MCP Server

olane copass --mcp

Starts a Model Context Protocol server over stdio, exposing all CLI capabilities as tools for AI agents.

MCP integration

Add Olane as an MCP server in your .mcp.json:

{
  "mcpServers": {
    "olane": {
      "type": "stdio",
      "command": "olane",
      "args": ["copass", "--mcp"]
    }
  }
}

Available MCP tools

| Tool | Description | |------|-------------| | check_project_status | Check project indexing status | | context_query | Natural language ontology queries | | context_summary | LLM-generated context summary for a canonical entity | | search_entities | Search the ontology | | ingest_code | Ingest source code | | ingest_text | Ingest text/documentation | | get_score | Score knowledge graph coverage for an entity, UUID, or free text; high scores → use context_query/context_summary for insights |

Copass scoring

Cosync scores measure confidence in the knowledge graph's understanding of entities:

| Tier | Meaning | |------|---------| | safe | High confidence, well-understood entity | | review | Moderate confidence, may benefit from verification | | caution | Low confidence, likely needs enrichment | | critical | Very low confidence, significant gaps | | cold_start | New entity with minimal data |

Use olane copass context <canonical-id> to get an LLM-generated summary of an entity's context.

Supported languages

Code ingestion supports: TypeScript, JavaScript, Python, Rust, Go, Java, Ruby, PHP, C, C++, C#, Swift, Kotlin, Scala, Bash, SQL, YAML, JSON, Markdown, HTML, CSS, SCSS, Vue, and Svelte.

Configuration

Global config (~/.olane/config.json)

Stores authentication tokens, API endpoints, and encryption keys. Created automatically on olane login.

Project config (.olane/config.json)

Stores project-specific settings including cosync thresholds, indexing schedules, and hook configuration. Created by olane setup. Continuous indexing settings are stored under the watch section, and successful full indexes refresh .olane/watch-state.json so background watching can resume without re-uploading unchanged files.

Environment variables

| Variable | Description | |----------|-------------| | OLANE_API_URL | API endpoint (default: https://ai.copass.id) | | OLANE_ENCRYPTION_KEY | Master encryption key | | OLANE_PROJECT_ID | Default project ID |

Security

All data in transit is encrypted using AES-256-GCM. Each project can have its own master encryption key, stored locally or provided via environment variable. Session tokens wrap a derived encryption key with your access token for secure API communication.

License

MIT