# Command Book

> Command Book is a native macOS application for managing long-running terminal commands. It provides a dedicated, persistent interface for running and monitoring processes like web servers, databases, background workers, and build tools.

## Overview

Command Book solves the fragile workflow of managing terminal tabs that can be lost, closed, or forgotten. Instead of juggling multiple terminal windows, developers save commands with metadata (name, working directory, environment variables) and run them reliably from a single app.

Key capabilities:

- Save and catalog commands with names, working directories, and environment variables
- Run commands through the user's login shell (preserving PATH, aliases, environment)
- Capture real-time output with configurable buffers up to 500,000 lines per process
- Full ANSI color support including 24-bit true color and text styling
- Command palette (Cmd+K) for keyboard-first workflow
- Auto-restart crashed processes with configurable delays
- Process memory and uptime monitoring in real-time
- Drag-and-drop sidebar organization with visual separators
- URL detection in output with one-click browser access
- CLI for running and managing commands from the terminal (commandbook run, list, new, edit, open)
- Native Swift and SwiftUI implementation (no Electron)

## Technical Details

- **Platform**: macOS 15.0+ (Sequoia). Windows version planned.
- **Language**: Swift 6 with SwiftUI
- **Database**: SQLite via GRDB.swift
- **Bundle ID**: com.talkpython.commandbook
- **Size**: ~21 MB on disk, ~73 MB in memory

## Pricing

- **Free Edition**: 5 saved commands, 10 ad-hoc commands, 25,000 lines output capture
- **Full Edition**: $14.99 one-time purchase, unlimited commands, 500,000 lines output

## Docs

- [AI Agent CLI Reference](https://commandbookapp.com/docs/ai-guide.md): Concise CLI reference for LLMs and coding agents (raw markdown)
- [Ad-hoc Commands](https://commandbookapp.com/docs/ad-hoc-commands): Running one-off commands without saving them
- [Backing Up Data](https://commandbookapp.com/docs/backing-up-data): Exporting and restoring command databases
- [CLI](https://commandbookapp.com/docs/cli): Documentation page
- [Command Configuration](https://commandbookapp.com/docs/commands): Creating, editing, and managing saved commands
- [Cookbooks & Examples](https://commandbookapp.com/docs/cookbooks-examples): Example command configurations for common tools
- [Getting Started](https://commandbookapp.com/docs/getting-started): Quick start guide for new users
- [Keyboard Shortcuts](https://commandbookapp.com/docs/keyboard-shortcuts): Complete keyboard shortcut reference
- [Organizing Commands](https://commandbookapp.com/docs/organizing-commands): Using sidebar separators and drag-drop to organize
- [Output & Display](https://commandbookapp.com/docs/output-display): ANSI color support, output buffers, and search
- [Shell Integration](https://commandbookapp.com/docs/shell-integration): How Command Book uses your login shell
- [Stopping Processes](https://commandbookapp.com/docs/stopping-processes): Signal hierarchy: SIGINT, SIGTERM, SIGKILL


## Links

- [Home](https://commandbookapp.com): Main landing page with features and pricing
- [FAQ](https://commandbookapp.com/faq): Frequently asked questions
- [Download](https://commandbookapp.com/download): Download the free edition
- [Buy](https://commandbookapp.com/buy): Purchase the full edition

## Optional

- [Sitemap](https://commandbookapp.com/sitemap.xml): XML sitemap for all pages