Skip to main content
@octen.ai/cli is the official command-line tool for Octen. One command wires Octen’s MCP server and Agent Skills into your AI client. It also brings the full Octen API straight to your terminal.

Get API Key

Create a key from the API Platform.

GitHub

View the source and releases.

npm

The @octen.ai/cli package.

​
Install

Requires Node.js 18+.
npm i -g @octen.ai/cli
Or run without installing: npx @octen.ai/cli <command>.

​
Authenticate

You’ll need an Octen API key first. Create one from the API Platform.
Set your key as an environment variable — every command picks it up automatically: 
export OCTEN_API_KEY="your-key"          # add to ~/.zshrc or ~/.bashrc to persist
You can also pass --api-key <key> on any single command. To point at a staging or self-hosted endpoint, set OCTEN_API_URL or pass --base-url <url>.

​
Set up your AI agent

One command merges the Octen MCP server or Agent Skills into your client.
Install the Octen Skills into your AI agent:
octen configure-skills --claude-code --set-key
Supported: Claude Code, Cursor, Codex, OpenClaw, Hermes. For Claude Desktop, use —claude-code.
--all configures every client found on your machine at once.

​
Use Octen from the terminal

CommandWhat it does
octen search <query>Ranked web results with relevant highlights and optional full content.
octen news <query>Fresh, ranked news results for current events and headlines.
octen fetch <urls...>Extract 1–20 URLs into clean, LLM-ready content.
octen chat [prompt]Chat completions from leading models, with optional live web search.
octen embed [text...]Text vectors for semantic search, RAG, and recommendations.
octen vl-embed <content...>Multimodal vectors from text, images, and video for cross-modal search.