← Back to DocsHome

Command Line Interface

Manage TaskForceAI directly from your terminal with our powerful CLI tool.

View on GitHub

Quick Start

Installation

The TaskForceAI CLI works on macOS, Linux, and Windows. No Go installation required - pre-built binaries included for all platforms.

macOS: Install with Homebrew (recommended)

brew tap ClayWarren/taskforceai && brew install taskforceai-cli

All Platforms: Install with npm (macOS, Linux, Windows)

npm install -g taskforceai-cli

Auto-Updates

By default, auto-updates are disabled for npm-managed installations to prevent permission issues. To opt-in to automatic background updates, set the following environment variable:

export TASKFORCEAI_ENABLE_AUTOUPDATE=1

Features

Interactive TUI

Beautiful terminal user interface with real-time updates and progress tracking

Conversation Management

Create, list, and manage conversations directly from the command line

Agent Orchestration

Run multi-agent workflows with live streaming output

Offline Support

Queue prompts when offline and sync automatically when connected

Local Mock Server

Run a mock API server for SDK development without needing an API key

Basic Usage

Start Interactive Mode

Launch the TUI and start a conversation

taskforceai

Send a Prompt

Run a single prompt and get results

taskforceai prompt "Explain quantum computing"

List Conversations

View all your conversations

taskforceai list

Set API Key

Configure your TaskForceAI API key

taskforceai config set-key YOUR_API_KEY

Configuration

The CLI stores configuration in ~/.taskforceai/config.toml

Example Configuration

[api]
endpoint = "https://taskforceai.chat/api"
key = "your-api-key-here"

[display]
theme = "dark"
show_agent_details = true

Local Mock Server

Build and test SDK integrations without an API key using the built-in mock server:

Interactive (within TUI)

/mock

Toggles the mock server on/off while using the TUI. Run /mock again to stop it.

Headless (for scripting and testing)

taskforceai --mock

Starts the mock server without the TUI. Useful for CI pipelines or SDK integration tests. Press Ctrl+C to stop.

The server runs at http://localhost:4321/api/developer and mirrors the production API. Point your SDK at this URL during development.

Keyboard Shortcuts

Ctrl+C

Exit application

Ctrl+N

New conversation

Ctrl+L

List conversations

↑/↓

Navigate history

Enter

Send prompt

Esc

Cancel input