@horizonai/cli is the npm distribution of the Horizon AI command-line interface — the same horizon binary that ships with the Horizon desktop app, packaged for npm install -g.

Install

npm install -g @horizonai/cli

Then:

horizon setup        # pick a provider, paste your key (30 seconds)
horizon              # launch interactive TUI
horizon "task"       # one-shot agent task
horizon chat "msg"   # single-turn chat
horizon serve        # headless HTTP API on :18789

Requires Node 20+. On Apple Silicon and Windows, the install pulls prebuilt better-sqlite3 binaries — no native toolchain needed.

What you get

• 25 AI providers + 300+ models via OpenRouter — Claude, GPT, Gemini, Groq, DeepSeek, Mistral, Qwen, Perplexity, Cohere, Grok, Together AI, Fireworks, DeepInfra, Cerebras, SambaNova, Moonshot Kimi, Z.AI / GLM, Nebius, OpenRouter aggregator, Azure OpenAI, custom OpenAI-compatible endpoint, plus local Ollama / LM Studio / LocalAI.
• 8-type memory — facts, episodic memories, conversations, semantic recall (256-dim embeddings), FTS index, user profile, persona memory, and per-workspace .horizon/memory.json.
• Skills system — three scopes (workspace / user / builtin), same SKILL.md format Anthropic uses, auto-pickup based on the query.
• Plugin sandbox — vm2-based isolation, granular permissions, signed marketplace plugins.
• TUI — keypress-based interactive shell, scrollback, in-chat search, multi-line composer, gradient spinner, markdown rendering.
• Headless HTTP API — horizon serve exposes the agent over JSON + Server-Sent Events for cron jobs, PWAs, and mobile clients.

Bring your own keys

Horizon never proxies your traffic. Your API keys sit encrypted in your OS user data directory (%APPDATA%/horizon-ai/ on Windows, ~/Library/Application Support/horizon-ai/ on macOS, ~/.config/horizon-ai/ on Linux) and the agent talks directly to your chosen provider.

Programmatic use

const { createHorizonRuntime, defaultUserDataDir } = require('@horizonai/cli');

const runtime = createHorizonRuntime()({
  userDataDir: defaultUserDataDir(),
  workspaceDir: process.cwd(),
});

The runtime exposes the same API the CLI commands and the Electron app use — agent loop, skills manager, memory DB, providers, plugins.

Other install paths

# macOS / Linux Homebrew
brew tap ErnestKostevich/tap https://github.com/ErnestKostevich/horizon-homebrew-tap
brew install horizon

# Windows Scoop
scoop bucket add horizon https://github.com/ErnestKostevich/horizon-scoop-bucket
scoop install horizon

# Or download a standalone binary (no Node required)
# https://github.com/ErnestKostevich/horizon-genesis/releases/latest

License

BUSL-1.1 — personal, educational, internal evaluation, and non-commercial production use is free. Hosting Horizon as a paid service or redistributing it commercially requires written permission. Plugins and workflows built on top of Horizon are unrestricted.

Links

• Source code
• User docs
• Website
• Report a bug