@olane/o-cli

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

# Query the knowledge graph
olane cosync 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

Cosync (Knowledge Graph)

Command	Description
olane cosync question <question>	Natural language Q&A against your ontology
olane cosync analyze <query>	Deep entity analysis with confidence scoring
olane cosync score <entity>	Get cosync score for a specific entity
olane cosync task <plan>	Get task readiness scores for planning
olane cosync learn <entity-ids...>	Get learning requests to fill knowledge gaps

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
cosync_question	Natural language ontology queries
cosync_analyze	Entity analysis with cosync scoring
search_entities	Search the ontology
ingest_code	Ingest source code
ingest_text	Ingest text/documentation
get_task_cosync	Task readiness scoring
get_score	Entity cosync scoring
get_learning_requests	Generate learning questions for knowledge gaps

Cosync 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 cosync learn to get targeted questions that improve low-scoring entities.

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.

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