@horatius/cli

Command-line interface for Horatius knowledge management platform.

Installation

npm install -g @horatius/cli

Setup

1. Get an API key from horatius.app/settings
2. Configure once, use everywhere:

hrt config set apiKey "hrt_your_api_key_here"

✨ This automatically works for both the CLI and MCP server! No need to configure multiple times.

Alternatively, use environment variable (e.g., for CI/CD):

export HORATIUS_API_KEY="hrt_your_api_key_here"

Usage

Add a solution

# Interactive mode
hrt add

# With flags
hrt add --title "Fix Docker permission error" \
        --content "Run: sudo usermod -aG docker $USER" \
        --tags "docker,linux,permissions"

List solutions

# List all (default: 10 most recent)
hrt list

# Filter by tag
hrt list --tag postgres

# Increase limit
hrt list --limit 50

Search solutions

hrt search "docker"

View solution

hrt get 123

Delete solution

hrt delete 123

Configuration

# Show all config
hrt config show

# Get specific value
hrt config get apiKey

# Set value
hrt config set apiKey "hrt_..."

# Delete value
hrt config delete apiKey

Configuration

The CLI stores configuration in ~/.horatius/config.json. This configuration is shared with the MCP server and other Horatius tools.

Configuration Priority:

1. Environment variables (highest priority)
2. Config file (~/.horatius/config.json)
3. Defaults

Environment Variables

• HORATIUS_API_KEY: Your API key (overrides config file)
• HORATIUS_API_URL: API base URL (default: https://horatius.app)

Shared Configuration

Setting your API key with hrt config set apiKey makes it available to:

• ✅ Horatius CLI (hrt command)
• ✅ Horatius MCP Server (for Claude Desktop, Claude Code)
• ✅ Horatius GUI (desktop application)

No need to configure each tool separately!

Development

# Install dependencies
npm install

# Link locally
npm link

# Test
hrt list

License

MIT