CLI

The komand CLI provides a terminal-first interface for interacting with your Komand agents. It connects to the same REST API as the web dashboard but is designed for developers and power users who prefer the command line.

Installation

dotnet tool install -g komand

Prompt Sessions

Interactive Mode

komand prompt

This opens an interactive prompt session connected to your default agent. Type naturally and the agent responds in real time.

|<_ komand prompt
Connected to agent: default

You: What meetings do I have tomorrow?
Agent: You have two meetings tomorrow:
  1. 10:00 AM — Standup with the engineering team
  2. 2:00 PM — Demo with Acme Corp (Bob Smith)

You: Reschedule the demo to 3pm
Agent: Done. I've moved the Acme Corp demo to 3:00 PM and notified Bob Smith.

Connect to a Specific Agent

komand prompt --agent sales-bot

Connect to a Remote Server

komand prompt --server https://app.komand.ai --token YOUR_API_TOKEN

One-Shot Commands

Send a single message without entering interactive mode:

komand prompt --message "How many open deals do I have?"

Pipe Input

echo "Summarize today's sales activity" | komand prompt

Agent Management

# List all agents
komand agent list

# Get agent details
komand agent info sales-bot

# Create or update an agent
komand agent create --id sales-bot --name "Sales Assistant" \
  --model claude-sonnet-4-20250514 \
  --prompt "You are a friendly sales assistant."

# Store a memory
komand agent memory set sales-bot company_timezone "Australia/Brisbane"

# Recall a memory
komand agent memory get sales-bot company_timezone

Skill Management

# Search the marketplace
komand skill search "crm contact"

# View skill details
komand skill info crm-contact-lookup

# Install a skill for an agent
komand skill install crm-contact-lookup --agent sales-bot

# List installed skills
komand skill list --agent sales-bot

Session Management

# View active sessions
komand session list

# Get session info
komand session info "WebChat:default:user-1"

# Bind an agent to a session
komand session bind "WebChat:default:user-1" --agent sales-bot

# End a session
komand session end "WebChat:default:user-1"

Configuration

The CLI stores configuration in ~/.komand/config.json:

{
  "server": "http://localhost:5000",
  "defaultAgent": "default",
  "token": null
}

Setting	Description
`server`	Komand API base URL
`defaultAgent`	Agent used when `--agent` is not specified
`token`	API token for authentication (set via `komand auth login`)

Authentication

# Login and store token
komand auth login --email jane@komand.ai

# Verify current authentication
komand auth whoami

# Logout (clear stored token)
komand auth logout

Output Formats

The CLI supports multiple output formats for scripting:

# Default: human-readable
komand agent list

# JSON output for scripting
komand agent list --output json

# Quiet mode (minimal output)
komand agent list --output quiet

Hosted Prompt

A hosted version of the CLI is available at prompt.komand.ai — a web-based terminal interface that works without installing anything. It connects to your Komand instance via the same API.