thinkt

CLI Guide

Mon, 01 Jan 0001 00:00:00 +0000

Command Line Interface#

thinkt provides a comprehensive CLI for exploring and analyzing AI coding assistant sessions. This guide covers the main commands and common workflows.

Quick Start#

# Launch the interactive TUI (default)
thinkt

# List all your projects
thinkt projects

# Browse sessions
thinkt sessions list
thinkt sessions view

Interactive TUI#

Running thinkt without arguments launches an interactive terminal UI with a navigation stack:

thinkt
thinkt tui # Explicit command
thinkt tui --log debug.log # With debug logging

The TUI navigates through three screens: Project Picker → Session Picker → Session Viewer. Press esc to go back, q or ctrl+c to quit.

Themes

Mon, 01 Jan 0001 00:00:00 +0000

Themes#

thinkt ships with 14 built-in themes. Browse them interactively with thinkt theme browse, or switch with thinkt theme set <name>.

You can also import iTerm2 color schemes to create your own.

**Tip:** Use `thinkt theme browse` to preview themes live in your terminal before committing to one.

Built-in Themes#

Each palette shows: accent, borders, text colors, label colors, and block backgrounds.

dark#

Default dark theme — thinkt theme set dark

Languages

Mon, 01 Jan 0001 00:00:00 +0000

Languages#

thinkt supports internationalization (i18n). You can switch between different languages for the CLI, TUI, and server messages.

Current Languages#

We currently support:

English (en) — Default
Chinese (Simplified) (zh-Hans) — 简体中文
Spanish (es) — Español

How to Set Language#

1. Environment Variable#

The easiest way to quickly switch languages is via the THINKT_LANG environment variable:

# Run in Spanish
THINKT_LANG=es thinkt

# Run in Chinese
THINKT_LANG=zh-Hans thinkt

2. Configuration#

You can permanently set your preferred language via the CLI:

MCP Server

Mon, 01 Jan 0001 00:00:00 +0000

MCP Server#

The thinkt server mcp command starts a Model Context Protocol server that exposes your AI coding session data to MCP-compatible clients. This allows AI assistants to query your session history, browse projects, and analyze past conversations.

Overview#

thinkt server mcp # MCP server on stdio (default)
thinkt server mcp --stdio # Explicitly use stdio transport
thinkt server mcp --port 8786 # MCP server over HTTP (SSE)

The MCP server supports two transport modes:

stdio (default): For direct integration with Claude Desktop and other stdio-based clients
HTTP/SSE: For web-based or networked clients using Server-Sent Events

Available Tools#

The MCP server exposes nine tools for exploring session data:

Lite Interface

Mon, 01 Jan 0001 00:00:00 +0000

Lite Interface#

The thinkt web lite command opens a lightweight web interface for exploring your AI coding sessions. It provides a quick overview of your sources, projects, and API access without the full TUI experience.

The lite interface is served at /lite/ on the main server (port 8784 by default).

Quick Start#

thinkt web lite # Open lite interface in browser
thinkt web lite --no-open # Don't auto-open browser

If the server is not already running, it will be started in the background.

Trace Collector

Mon, 01 Jan 0001 00:00:00 +0000

Trace Collector & Exporter#

thinkt includes a push-based trace collection system for aggregating AI coding assistant traces from multiple machines into a central store. This enables team-wide observability, cross-machine analytics, and centralized trace governance.

Architecture#

┌────────────────────┐ ┌────────────────────┐
│ Machine A │ │ Machine B │
│ ┌──────────────┐ │ │ ┌──────────────┐ │
│ │ thinkt │ │ │ │ thinkt │ │
│ │ export │──┼─┐ │ │ export │──┼─┐
│ │ --forward │ │ │ │ │ --forward │ │ │
│ └──────────────┘ │ │ │ └──────────────┘ │ │
│ watches ~/.claude │ │ │ watches ~/.kimi │ │
└────────────────────┘ │ └────────────────────┘ │
 │ │
 │ POST /v1/traces │
 ▼ ▼
 ┌──────────────────────────────────┐
 │ thinkt collect │
 │ │
 │ ┌─────────┐ ┌───────────────┐ │
 │ │ Agent │ │ DuckDB │ │
 │ │ Registry│ │ collector.duckdb│ │
 │ └─────────┘ └───────────────┘ │
 │ │
 │ REST API on port 8785 │
 └──────────────────────────────────┘

The system has two components:

REST API

Mon, 01 Jan 0001 00:00:00 +0000

REST API#

thinkt provides a REST API for programmatic access to AI coding session data. The API is available through the HTTP server and includes interactive Swagger documentation.

Quick Start#

# Start the server (foreground, port 8784)
thinkt server

# Start in background
thinkt server start

# Open web interface (auto-starts server if needed)
thinkt web

# Custom port
thinkt server -p 8080

Once running, access the API at http://localhost:8784/api/v1/ (or your configured port).

Docker

Mon, 01 Jan 0001 00:00:00 +0000

Docker#

Run thinkt in a Docker container for sandboxed, read-only access to your AI coding sessions. This provides isolation between the tool and your system while still allowing exploration of your conversation history.

Quick Start#

# Pull the image
docker pull ghcr.io/wethinkt/thinkt:latest

# List your Claude Code projects
docker run --rm \
 -v ~/.claude:/data/.claude:ro \
 ghcr.io/wethinkt/thinkt projects

# Start the web server
docker run --rm -p 8784:8784 \
 -v ~/.claude:/data/.claude:ro \
 ghcr.io/wethinkt/thinkt server --host 0.0.0.0

Why Use Docker?#

Running thinkt in a container provides several benefits:

For LLMs

Mon, 01 Jan 0001 00:00:00 +0000

Guide for AI Assistants#

This page is designed for AI assistants and LLMs to understand how to use thinkt tools effectively. For the plain-text version optimized for LLM context windows, see /llms.txt or invoke thinkt docs llms.

What is thinkt?#

thinkt provides unified access to AI coding assistant session data from:

Claude Code (~/.claude/)
Kimi Code (~/.kimi/)
Gemini CLI (~/.gemini/)
Copilot CLI (~/.copilot/)
Codex CLI (~/.codex/)
Qwen Code (~/.qwen/)

Access methods: CLI, REST API, MCP, Go library.

thinkt

Mon, 01 Jan 0001 00:00:00 +0000

thinkt#

Tools for AI assistant session exploration and extraction

Synopsis#

thinkt provides tools for exploring and extracting data from AI coding assistant sessions.

Supports: Claude Code, Kimi Code, Gemini CLI, GitHub Copilot CLI, Codex CLI

Running without a subcommand launches the interactive TUI.

Commands: sources Manage and view available session sources tui Launch interactive TUI explorer (default) prompts Extract and manage prompts from trace files projects List and manage projects sessions List and manage sessions

thinkt agents

Mon, 01 Jan 0001 00:00:00 +0000

thinkt agents#

List active agents (local and remote)

Synopsis#

List all currently active AI coding agents across local and remote infrastructure.

Local agents are detected via process inspection, IDE lock files, and file modification times. Remote agents are discovered from running collector instances.

Examples: thinkt agents # List all active agents thinkt agents –local # Local agents only thinkt agents –remote # Remote agents only (from collectors) thinkt agents –source claude # Filter by source thinkt agents –json # JSON output

thinkt agents follow

Mon, 01 Jan 0001 00:00:00 +0000

thinkt agents follow#

Live-tail an agent’s conversation

Synopsis#

Stream new conversation entries from an active agent in real-time.

Local agents are tailed directly from their session files. Remote agents are streamed via WebSocket from the collector.

Examples: thinkt agents follow a3f8b2c1 # Tail agent conversation thinkt agents follow a3f8b2c1 –json # Structured JSON output thinkt agents follow a3f8b2c1 –raw # Raw JSONL

thinkt agents follow [session-id] [flags]

Options#

 -h, --help help for follow
 --json structured JSON output
 --raw raw JSONL output

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt apps

Mon, 01 Jan 0001 00:00:00 +0000

thinkt apps#

Manage open-in apps and default terminal

Synopsis#

Manage the apps available for “open in” actions and the default terminal.

Apps are configured in ~/.thinkt/config.json.

Examples: thinkt apps # List all apps thinkt apps list # List all apps thinkt apps enable vscode # Enable an app thinkt apps disable finder # Disable an app thinkt apps get-terminal # Show default terminal thinkt apps set-terminal ghostty # Set default terminal thinkt apps set-terminal # Interactive terminal picker

thinkt apps disable

Mon, 01 Jan 0001 00:00:00 +0000

thinkt apps disable#

Disable an app

thinkt apps disable [id] [flags]

Options#

 -h, --help help for disable

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt apps enable

Mon, 01 Jan 0001 00:00:00 +0000

thinkt apps enable#

Enable an app

thinkt apps enable [id] [flags]

Options#

 -h, --help help for enable

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt apps get-terminal

Mon, 01 Jan 0001 00:00:00 +0000

thinkt apps get-terminal#

Show the configured default terminal app

thinkt apps get-terminal [flags]

Options#

 -h, --help help for get-terminal

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt apps list

Mon, 01 Jan 0001 00:00:00 +0000

thinkt apps list#

List all apps with enabled/disabled status

thinkt apps list [flags]

Options#

 -h, --help help for list

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt apps set-terminal

Mon, 01 Jan 0001 00:00:00 +0000

thinkt apps set-terminal#

Set the default terminal app

Synopsis#

Set the default terminal app. Without an argument, launches an interactive picker.

thinkt apps set-terminal [id] [flags]

Options#

 -h, --help help for set-terminal

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt collect

Mon, 01 Jan 0001 00:00:00 +0000

thinkt collect#

Start trace collector server

Synopsis#

Start a collector server that receives AI coding assistant traces from exporters.

The collector provides:

POST /v1/traces endpoint for trace ingestion
Agent registration and heartbeat tracking
DuckDB-backed storage for collected traces
Bearer token authentication (optional)

All received traces are stored locally in DuckDB for analysis.

Examples: thinkt collect # Start collector on port 8785 thinkt collect –port 8785 # Custom port thinkt collect –token mytoken # Require bearer token auth thinkt collect –storage ./traces.duckdb # Custom storage path

thinkt collect export-parquet

Mon, 01 Jan 0001 00:00:00 +0000

thinkt collect export-parquet#

Export collected traces to Parquet files

Synopsis#

Export collected traces from the DuckDB store to Parquet files.

This is a standalone operation that should be run when the collector is not running. DuckDB handles Parquet encoding natively — no external library needed.

Examples: thinkt collect export-parquet thinkt collect export-parquet –out /tmp/parquet-export thinkt collect export-parquet –since 2025-01-01 –until 2025-02-01

thinkt collect export-parquet [flags]

Options#

 -h, --help help for export-parquet
 --out string output directory (default: ~/.thinkt/exports/parquet/)
 --since string only entries after this time (RFC3339 or YYYY-MM-DD)
 --storage string path to collector.duckdb (default: ~/.thinkt/dbs/collector.duckdb)
 --until string only entries before this time (RFC3339 or YYYY-MM-DD)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt completion

Mon, 01 Jan 0001 00:00:00 +0000

thinkt completion#

Generate the autocompletion script for the specified shell

Synopsis#

Generate the autocompletion script for thinkt for the specified shell. See each sub-command’s help for details on how to use the generated script.

Options#

 -h, --help help for completion

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt completion bash

Mon, 01 Jan 0001 00:00:00 +0000

thinkt completion bash#

Generate the autocompletion script for bash

Synopsis#

Generate the autocompletion script for the bash shell.

This script depends on the ‘bash-completion’ package. If it is not installed already, you can install it via your OS’s package manager.

To load completions in your current shell session:

source <(thinkt completion bash)

To load completions for every new session, execute once:

Linux:#

thinkt completion bash > /etc/bash_completion.d/thinkt

macOS:#

thinkt completion bash > $(brew --prefix)/etc/bash_completion.d/thinkt

You will need to start a new shell for this setup to take effect.

thinkt completion fish

Mon, 01 Jan 0001 00:00:00 +0000

thinkt completion fish#

Generate the autocompletion script for fish

Synopsis#

Generate the autocompletion script for the fish shell.

To load completions in your current shell session:

thinkt completion fish | source

To load completions for every new session, execute once:

thinkt completion fish > ~/.config/fish/completions/thinkt.fish

You will need to start a new shell for this setup to take effect.

thinkt completion fish [flags]

Options#

 -h, --help help for fish
 --no-descriptions disable completion descriptions

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt completion powershell

Mon, 01 Jan 0001 00:00:00 +0000

thinkt completion powershell#

Generate the autocompletion script for powershell

Synopsis#

Generate the autocompletion script for powershell.

To load completions in your current shell session:

thinkt completion powershell | Out-String | Invoke-Expression

To load completions for every new session, add the output of the above command to your powershell profile.

thinkt completion powershell [flags]

Options#

 -h, --help help for powershell
 --no-descriptions disable completion descriptions

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt completion zsh

Mon, 01 Jan 0001 00:00:00 +0000

thinkt completion zsh#

Generate the autocompletion script for zsh

Synopsis#

Generate the autocompletion script for the zsh shell.

If shell completion is not already enabled in your environment you will need to enable it. You can execute the following once:

echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions in your current shell session:

source <(thinkt completion zsh)

To load completions for every new session, execute once:

thinkt docs

Mon, 01 Jan 0001 00:00:00 +0000

thinkt docs#

Generate documentation for thinkt

Synopsis#

Generate documentation for all thinkt commands.

Subcommands: markdown Generate plain markdown (default) man Generate man pages

The auto-generation tag (timestamp footer) is disabled by default for stable, reproducible files. Use –enableAutoGenTag for publishing.

Examples: thinkt docs # Generate markdown docs in ./docs/ thinkt docs markdown -o ./wiki # Generate markdown in custom directory thinkt docs markdown –hugo -o docs/command # Generate Hugo-compatible docs thinkt docs man -o /usr/share/man/man1

thinkt docs man

Mon, 01 Jan 0001 00:00:00 +0000

thinkt docs man#

Generate man pages

Synopsis#

Generate man pages for all thinkt commands.

Man pages are generated in roff format suitable for installation in /usr/share/man/man1 or /usr/local/share/man/man1.

thinkt docs man [flags]

Options#

 -h, --help help for man

Options inherited from parent commands#

 --enableAutoGenTag include auto-generation tag (timestamp footer) for publishing
 -o, --output string output directory for generated docs (default "./docs")
 -v, --verbose verbose output

thinkt docs markdown

Mon, 01 Jan 0001 00:00:00 +0000

thinkt docs markdown#

Generate markdown documentation

Synopsis#

Generate markdown documentation for all thinkt commands.

By default, generates plain markdown suitable for GitHub wikis and basic documentation sites. Use –hugo to generate markdown with YAML front matter for Hugo static site generator.

thinkt docs markdown [flags]

Options#

 -h, --help help for markdown
 --hugo generate Hugo-compatible markdown with YAML front matter

Options inherited from parent commands#

 --enableAutoGenTag include auto-generation tag (timestamp footer) for publishing
 -o, --output string output directory for generated docs (default "./docs")
 -v, --verbose verbose output

thinkt embeddings

Mon, 01 Jan 0001 00:00:00 +0000

thinkt embeddings#

Manage embedding model, storage, and sync

thinkt embeddings [flags]

Options#

 -h, --help help for embeddings

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt export

Mon, 01 Jan 0001 00:00:00 +0000

thinkt export#

Export traces to a remote collector

Synopsis#

Export local AI coding assistant traces to a remote collector endpoint.

By default, performs a one-shot export of all traces found in source directories. Use –forward for continuous watch mode that ships traces as they are written.

The collector endpoint is discovered automatically:

–collector-url flag or THINKT_COLLECTOR_URL env var
.thinkt/collector.json in the project directory
Well-known endpoint discovery
Local buffer only (no remote)

Examples: thinkt export # One-shot export of all traces thinkt export –forward # Watch mode: continuously forward traces thinkt export –flush # Flush the disk buffer thinkt export –source claude # Export only Claude traces thinkt export –collector-url https://collect.example.com/v1/traces

thinkt help

Mon, 01 Jan 0001 00:00:00 +0000

thinkt help#

Help topics for thinkt

Synopsis#

Help about any command, or ’thinkt help llms’ for AI assistant usage guide.

thinkt help [command] [flags]

Options#

 -h, --help help for help

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt help cheat

Mon, 01 Jan 0001 00:00:00 +0000

thinkt help cheat#

Quick-reference command tree

Synopsis#

Print a compact cheat sheet showing every command and subcommand.

thinkt help cheat [flags]

Options#

 -h, --help help for cheat
 --json output as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt help llms

Mon, 01 Jan 0001 00:00:00 +0000

thinkt help llms#

Usage guide for LLMs and AI assistants

Synopsis#

Print a guide for LLMs on using thinkt via CLI, MCP, and REST API.

thinkt help llms [flags]

Options#

 -h, --help help for llms

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt indexer

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer#

Specialized indexing and search via DuckDB (requires thinkt-indexer)

Synopsis#

The indexer command provides access to DuckDB-powered indexing and search capabilities. This requires the ’thinkt-indexer’ binary to be installed separately due to its CGO dependencies.

Examples: thinkt indexer start # Start indexer in background thinkt indexer status # Check indexer status thinkt indexer stop # Stop background indexer thinkt indexer sync # Sync all local sessions to the index thinkt indexer search “query” # Search across all sessions thinkt indexer summarize tags “trace tag” # Suggest shareable tags

thinkt indexer embeddings

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer embeddings#

Manage embedding model, storage, and sync

thinkt indexer embeddings [flags]

Options#

 -h, --help help for embeddings

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer help

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer help#

Help about any command

thinkt indexer help [flags]

Options#

 -h, --help help for help

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer logs

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer logs#

View indexer logs

thinkt indexer logs [flags]

Options#

 -f, --follow follow log output
 -h, --help help for logs
 -n, --lines int number of lines to show (default 50)

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer metrics

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer metrics#

Show Prometheus metrics from the running indexer

thinkt indexer metrics [flags]

Options#

 -h, --help help for metrics

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer search

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer search#

Search for text across indexed sessions

thinkt indexer search [flags]

Options#

 -h, --help help for search

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer semantic

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer semantic#

Semantic search and index management

thinkt indexer semantic [flags]

Options#

 -h, --help help for semantic

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer sessions

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer sessions#

List sessions for a project from the index

thinkt indexer sessions [flags]

Options#

 -h, --help help for sessions

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer start

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer start#

Start indexer in background

thinkt indexer start [flags]

Options#

 -h, --help help for start

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer stats

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer stats#

Show usage statistics from the index

thinkt indexer stats [flags]

Options#

 -h, --help help for stats

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer status

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer status#

Show indexer status

thinkt indexer status [flags]

Options#

 -h, --help help for status
 --json output as JSON

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer stop

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer stop#

Stop background indexer

thinkt indexer stop [flags]

Options#

 -h, --help help for stop

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer summarize

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer summarize#

Manage summarization model, storage, sync, and tags

thinkt indexer summarize [flags]

Options#

 -h, --help help for summarize

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer sync

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer sync#

Synchronize all local sessions into the index

thinkt indexer sync [flags]

Options#

 -h, --help help for sync

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt indexer version

Mon, 01 Jan 0001 00:00:00 +0000

thinkt indexer version#

Print version information

thinkt indexer version [flags]

Options#

 -h, --help help for version

Options inherited from parent commands#

 --db string path to DuckDB index database file
 --embeddings-db string path to DuckDB embeddings database file
 --log string path to log file
 -q, --quiet suppress progress output
 -v, --verbose verbose output

thinkt language

Mon, 01 Jan 0001 00:00:00 +0000

thinkt language#

Get or set the display language

Synopsis#

Get or set the display language.

Running without a subcommand shows the current language.

Examples: thinkt language # show current language thinkt language get –json # JSON output thinkt language list # list available languages thinkt language set zh-Hans # set directly thinkt language set # interactive picker

thinkt language [flags]

Options#

 -h, --help help for language

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt language get

Mon, 01 Jan 0001 00:00:00 +0000

thinkt language get#

Show current display language

thinkt language get [flags]

Options#

 -h, --help help for get
 --json output as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt language list

Mon, 01 Jan 0001 00:00:00 +0000

List available languages

thinkt language list [flags]

Options#

 -h, --help help for list
 --json output as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt language set

Mon, 01 Jan 0001 00:00:00 +0000

thinkt language set#

Set the display language

Synopsis#

Set the display language. Use a BCP 47 tag (e.g., en, zh-Hans).

Without an argument, launches an interactive picker (requires a terminal).

Examples: thinkt language set zh-Hans # set to Chinese (Simplified) thinkt language set # interactive picker

thinkt language set [lang] [flags]

Options#

 -h, --help help for set

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt projects

Mon, 01 Jan 0001 00:00:00 +0000

thinkt projects#

Manage and view projects

Synopsis#

Manage and view projects from available sources (Kimi, Claude, Gemini, Copilot, Codex, Qwen).

By default, this command launches the interactive project browser (TUI). Use subcommands to list, summarize, or manage projects via CLI.

Examples: thinkt projects # Launch interactive browser (default) thinkt projects list # List detailed columns thinkt projects list –short # List paths only thinkt projects summary # Detailed summary with session names thinkt projects tree # Tree view

thinkt projects copy

Mon, 01 Jan 0001 00:00:00 +0000

thinkt projects copy#

Copy project sessions to a target directory

Synopsis#

Copy all session files from a project to a target directory.

The project-path can be:

Full project path (e.g., /Users/evan/myproject)
Path relative to current directory

The target directory will be created if it doesn’t exist. Session files and index files are copied.

Examples: thinkt projects copy /Users/evan/myproject ./backup thinkt projects copy /Users/evan/myproject /tmp/export

thinkt projects copy <project-path> <target-dir> [flags]

Options#

 -h, --help help for copy

Options inherited from parent commands#

 -s, --source stringArray source to include (kimi|claude|gemini|copilot|codex|qwen, can be specified multiple times, default: all)
 -v, --verbose verbose output

thinkt projects list

Mon, 01 Jan 0001 00:00:00 +0000

thinkt projects list#

List projects from all sources

Synopsis#

List all projects from available sources (Kimi, Claude, Gemini, Copilot, Codex, Qwen).

By default, shows detailed columns (path, source, sessions, modified time). Use –short for a compact list of project paths only. Use –json for JSON output.

Examples: thinkt projects list # Detailed columns thinkt projects list –short # Paths only, one per line thinkt projects list –json # JSON output thinkt projects list –source kimi # Only Kimi projects thinkt projects list –source qwen # Only Qwen projects

thinkt projects summary

Mon, 01 Jan 0001 00:00:00 +0000

thinkt projects summary#

Show detailed project summary

Synopsis#

Show detailed information about each project including session count and last modified time.

Sorting: –sort name|time Sort by project name or modified time (default: time) –desc Sort descending (default for time) –asc Sort ascending (default for name)

Output can be customized with a Go text/template via –template.

Template Variables#

Each project in the list has: .Path string - Full project path (or “~” for home) .DisplayName string - Short name (last path component) .SessionCount int - Number of sessions .Modified string - Last modified time (may be empty) .DirPath string - Path to project directory .Source string - Source type (kimi, claude) .Sessions []SessionSummary - Session details (with –with-sessions flag)

thinkt projects tree

Mon, 01 Jan 0001 00:00:00 +0000

thinkt projects tree#

Show projects in a tree view

Synopsis#

Show projects grouped by parent directory in a tree layout.

thinkt projects tree [flags]

Options#

 -h, --help help for tree

Options inherited from parent commands#

 -s, --source stringArray source to include (kimi|claude|gemini|copilot|codex|qwen, can be specified multiple times, default: all)
 -v, --verbose verbose output

thinkt projects view

Mon, 01 Jan 0001 00:00:00 +0000

thinkt projects view#

Interactive project browser

Synopsis#

Launch the interactive TUI project browser. This allows you to navigate projects and select sessions to view.

thinkt projects view [flags]

Options#

 -h, --help help for view

Options inherited from parent commands#

 -s, --source stringArray source to include (kimi|claude|gemini|copilot|codex|qwen, can be specified multiple times, default: all)
 -v, --verbose verbose output

thinkt prompts

Mon, 01 Jan 0001 00:00:00 +0000

thinkt prompts#

Extract and manage prompts from trace files

Synopsis#

Extract user prompts from LLM agent trace files and generate output in various formats.

Supported trace types: claude Claude Code JSONL traces (~/.claude/projects/)

Examples: thinkt prompts extract -i session.jsonl thinkt prompts extract # uses latest session thinkt prompts list thinkt prompts info thinkt prompts templates

Options#

 -h, --help help for prompts
 -t, --type string trace type (claude) (default "claude")

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt prompts extract

Mon, 01 Jan 0001 00:00:00 +0000

thinkt prompts extract#

Extract prompts from a trace file

thinkt prompts extract [flags]

Options#

 -a, --append append to existing file
 -f, --format string output format (markdown|json|plain) (default "markdown")
 -h, --help help for extract
 -i, --input string input trace file (use - for stdin)
 -o, --output string output file (default stdout) (default "-")
 --template string custom template file (for markdown format)

Options inherited from parent commands#

 -t, --type string trace type (claude) (default "claude")
 -v, --verbose verbose output

thinkt prompts info

Mon, 01 Jan 0001 00:00:00 +0000

thinkt prompts info#

Show session information

thinkt prompts info [file] [flags]

Options#

 -h, --help help for info

Options inherited from parent commands#

 -t, --type string trace type (claude) (default "claude")
 -v, --verbose verbose output

thinkt prompts list

Mon, 01 Jan 0001 00:00:00 +0000

thinkt prompts list#

List available trace files

thinkt prompts list [flags]

Options#

 -h, --help help for list

Options inherited from parent commands#

 -t, --type string trace type (claude) (default "claude")
 -v, --verbose verbose output

thinkt prompts templates

Mon, 01 Jan 0001 00:00:00 +0000

thinkt prompts templates#

List available templates and show template variables

thinkt prompts templates [flags]

Options#

 -h, --help help for templates

Options inherited from parent commands#

 -t, --type string trace type (claude) (default "claude")
 -v, --verbose verbose output

thinkt search

Mon, 01 Jan 0001 00:00:00 +0000

thinkt search#

Search for text across indexed sessions

thinkt search [flags]

Options#

 -h, --help help for search

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt semantic

Mon, 01 Jan 0001 00:00:00 +0000

thinkt semantic#

Search sessions by meaning using on-device embeddings

thinkt semantic [flags]

Options#

 -h, --help help for semantic

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server#

Manage the local HTTP server for trace exploration

Synopsis#

Manage the local HTTP server for exploring AI conversation traces.

The server provides:

REST API for accessing projects and sessions
Web interface for visual trace exploration
MCP (Model Context Protocol) server

All data stays on your machine - nothing is uploaded to external servers.

Examples: thinkt server # Show server status thinkt server run # Start server in foreground thinkt server start # Start in background thinkt server status # Check server status thinkt server stop # Stop background server thinkt server logs # View server logs

thinkt server fingerprint

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server fingerprint#

Display the machine fingerprint

Synopsis#

Display the unique machine fingerprint used to identify this workspace.

The fingerprint is derived from system identifiers when available:

macOS: IOPlatformUUID from ioreg
Linux: /etc/machine-id or /var/lib/dbus/machine-id
Windows: MachineGuid from registry

If no system identifier is available, a fingerprint is generated and cached in ~/.thinkt/machine_id for consistency across restarts.

This fingerprint can be used to correlate sessions across different AI coding assistant sources (Kimi, Claude, Gemini, Copilot, Codex, Qwen) on the same machine.

thinkt server http-logs

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server http-logs#

View HTTP access logs

thinkt server http-logs [flags]

Options#

 -f, --follow follow log output
 -h, --help help for http-logs
 -n, --lines int number of lines to show (default 50)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server logs

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server logs#

View server logs

thinkt server logs [flags]

Options#

 -f, --follow follow log output
 -h, --help help for logs
 -n, --lines int number of lines to show (default 50)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server mcp

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server mcp#

Start MCP server for AI tool integration

Synopsis#

Start an MCP (Model Context Protocol) server for AI tool integration.

By default, runs on stdio for use with Claude Desktop and other MCP clients. Use –port to run over HTTP instead.

Authentication: For stdio transport: Set THINKT_MCP_TOKEN environment variable For HTTP transport: Use –token flag or THINKT_MCP_TOKEN environment variable Clients must pass the token in the Authorization header: “Bearer ” Generate a secure token with: thinkt server token

thinkt server metrics

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server metrics#

Fetch Prometheus metrics from the running server

thinkt server metrics [flags]

Options#

 -h, --help help for metrics

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server run

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server run#

Start server in foreground

thinkt server run [flags]

Options#

 --cors-origin string CORS Access-Control-Allow-Origin (default "*" when unauthenticated, disabled when authenticated; env: THINKT_CORS_ORIGIN)
 --dev string dev mode: proxy non-API routes to this URL (e.g. http://localhost:8784)
 -h, --help help for run
 --host string server host (default "localhost")
 --http-log string write HTTP access log to file (default: stdout, unless --quiet)
 --log string write debug log to file
 --no-auth disable authentication (allow unauthenticated access)
 --no-indexer don't auto-start the background indexer
 -p, --port int server port (default 8784)
 -q, --quiet suppress HTTP request logging (errors still go to stderr)
 --token string bearer token for API authentication (default: use THINKT_API_TOKEN env var)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server start

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server start#

Start server in background

thinkt server start [flags]

Options#

 --cors-origin string CORS Access-Control-Allow-Origin (default "*" when unauthenticated, disabled when authenticated; env: THINKT_CORS_ORIGIN)
 -h, --help help for start
 --host string server host (default "localhost")
 --no-auth disable authentication (allow unauthenticated access)
 --no-indexer don't auto-start the background indexer
 -p, --port int server port (default 8784)
 -q, --quiet suppress HTTP request logging (errors still go to stderr)
 --token string bearer token for API authentication (default: use THINKT_API_TOKEN env var)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server status

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server status#

Show server status

thinkt server status [flags]

Options#

 -h, --help help for status
 --json output as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server stop

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server stop#

Stop background server

thinkt server stop [flags]

Options#

 -h, --help help for stop

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server token

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server token#

Manage authentication tokens

Synopsis#

Manage authentication tokens for API and MCP server access.

thinkt server token [flags]

Options#

 -h, --help help for token

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt server token generate

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server token generate#

Generate a new authentication token

Synopsis#

Generate a cryptographically secure random token for API/MCP authentication.

The token can be used with:

thinkt server run –token # Secure the REST API
thinkt server mcp –token # Secure the MCP server
THINKT_MCP_TOKEN env var # Same as above

The token format is: thinkt_YYYYMMDD_

Examples: thinkt server token generate # Generate and print a token thinkt server token generate | pbcopy # Copy to clipboard (macOS) thinkt server token generate | xclip -sel c # Copy to clipboard (Linux) thinkt server token generate | clip # Copy to clipboard (Windows) export THINKT_MCP_TOKEN=$(thinkt server token generate) thinkt server mcp –port 8786 # Uses token from env

thinkt server token show

Mon, 01 Jan 0001 00:00:00 +0000

thinkt server token show#

Print the running server’s authentication token

Synopsis#

Print the authentication token for a running server.

Exits with an error if no server is running or it has no token.

Examples: thinkt server token show # Print the active token thinkt server token show | pbcopy # Copy to clipboard (macOS)

thinkt server token show [flags]

Options#

 -h, --help help for show

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt sessions

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions#

View and manage sessions across all sources

Synopsis#

View and manage sessions from all discovered sources.

Running without a subcommand launches the interactive session viewer.

Project selection:

In a project directory: automatically uses that project
Otherwise: shows interactive project picker
-p/–project : use specified project
–pick: force picker even if in a project directory

Use –source to filter by source (e.g. claude, kimi, gemini, copilot, codex, qwen).

Examples: thinkt sessions # Interactive viewer (same as view) thinkt sessions view # Interactive picker thinkt sessions list # Auto-detect or picker thinkt sessions list –pick # Force project picker thinkt sessions list -p ./myproject thinkt sessions summary -p ./myproject –source kimi thinkt sessions delete -p ./myproject thinkt sessions copy -p ./myproject ./backup

thinkt sessions copy

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions copy#

Copy a session to a target location

Synopsis#

Copy a known session file to a target location.

The session can be specified as:

Full path to a known session file
Session ID (requires -p/–project)
Filename (requires -p/–project)

The target can be a file path or directory.

Examples: thinkt sessions copy /full/path/to/session ./backup/ thinkt sessions copy -p ./myproject abc123 ./backup/ thinkt sessions copy -p ./myproject abc123 ./backup/renamed-session

thinkt sessions copy <session> <target> [flags]

Options#

 -h, --help help for copy

Options inherited from parent commands#

 --log string write debug log to file
 --pick force project picker even if in a known project directory
 -p, --project string project path (auto-detects from cwd if not set)
 -s, --source stringArray filter by source (claude|kimi|gemini|copilot|codex|qwen, can be specified multiple times)
 -v, --verbose verbose output

thinkt sessions delete

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions delete#

Delete a session

Synopsis#

Delete a session file from a known source.

The session can be specified as:

Full path to a known session file
Session ID (requires -p/–project)
Filename (requires -p/–project)

Before deletion, shows session info and prompts for confirmation. Use –force to skip the confirmation.

Examples: thinkt sessions delete /full/path/to/session thinkt sessions delete -p ./myproject abc123 thinkt sessions delete -p ./myproject –force abc123

thinkt sessions delete <session> [flags]

Options#

 -f, --force skip confirmation prompt
 -h, --help help for delete

Options inherited from parent commands#

 --log string write debug log to file
 --pick force project picker even if in a known project directory
 -p, --project string project path (auto-detects from cwd if not set)
 -s, --source stringArray filter by source (claude|kimi|gemini|copilot|codex|qwen, can be specified multiple times)
 -v, --verbose verbose output

thinkt sessions list

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions list#

List sessions (auto-detects project from cwd)

Synopsis#

List all sessions in a project.

Project selection:

In a project directory: automatically uses that project
Otherwise: shows interactive project picker
-p/–project : use specified project
–pick: force picker even if in a project directory

Examples: thinkt sessions list # Auto-detect from cwd or picker thinkt sessions list –pick # Force project picker thinkt sessions list -p ./myproject thinkt sessions list –source kimi thinkt sessions list –source qwen thinkt sessions list –json # JSON output

thinkt sessions resolve

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions resolve#

Resolve a session query to its canonical path

Synopsis#

Resolve a session query (ID, filename suffix, or absolute path) to a known session from registered sources.

By default, outputs only the canonical full path. Use –json for structured output.

thinkt sessions resolve <session> [flags]

Options#

 -h, --help help for resolve
 --json output resolved session metadata as JSON

Options inherited from parent commands#

 --log string write debug log to file
 --pick force project picker even if in a known project directory
 -p, --project string project path (auto-detects from cwd if not set)
 -s, --source stringArray filter by source (claude|kimi|gemini|copilot|codex|qwen, can be specified multiple times)
 -v, --verbose verbose output

thinkt sessions resume

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions resume#

Resume a session in its original CLI tool

Synopsis#

Resume a session in its original CLI tool (e.g., claude –resume).

If no session is specified, shows an interactive picker. Only sources that support resume (e.g., Claude Code, Kimi Code) are available.

The session can be specified as:

Full path to a known session file
Session ID (requires -p/–project)
Filename (requires -p/–project)

Examples: thinkt sessions resume # Interactive picker thinkt sessions resume -p ./myproject abc123 thinkt sessions resume /full/path/to/session.jsonl

thinkt sessions summary

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions summary#

Show detailed session summary

Synopsis#

Show detailed information about each session in a project.

Sorting: –sort name|time Sort by session name or modified time (default: time) –desc Sort descending (default for time) –asc Sort ascending (default for name)

Output can be customized with a Go text/template via –template.

Template variables: Full path to session file Session identifier Source type (kimi, claude) First prompt summary (if available) Number of messages Creation time (time.Time) Last modified time (time.Time) Git branch (if available)

thinkt sessions view

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sessions view#

View a session in the terminal (interactive picker)

Synopsis#

View a session in a full-terminal viewer.

If no session is specified, shows an interactive picker of all recent sessions. The picker works across all discovered sources.

The session can be specified as:

Full path to a known session file
Session ID (requires -p/–project)
Filename (requires -p/–project)

Navigation: ↑/↓/j/k Scroll up/down PgUp/PgDn Page up/down g/G Go to top/bottom q/Esc Quit

thinkt setup

Mon, 01 Jan 0001 00:00:00 +0000

thinkt setup#

Scan for AI session sources and configure thinkt

thinkt setup [flags]

Options#

 -h, --help help for setup
 --json output setup results as JSON
 --ok accept all defaults without prompts

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt sources

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sources#

Manage and view available session sources

Synopsis#

View and manage available AI assistant session sources.

Sources are the AI coding assistants that store session data on this machine (e.g., Claude Code, Kimi Code, Gemini CLI, Copilot CLI, Codex CLI).

Examples: thinkt sources list # List all available sources thinkt sources status # Show detailed source status thinkt sources enable claude # Enable a source thinkt sources disable kimi # Disable a source thinkt sources enable –all # Enable all sources thinkt sources disable –all # Disable all sources

thinkt sources disable

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sources disable#

Disable a source

Synopsis#

Disable a source so it is excluded from all commands. Use –all to disable all sources.

thinkt sources disable [source] [flags]

Options#

 --all disable all sources
 -h, --help help for disable

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt sources enable

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sources enable#

Enable a source

Synopsis#

Enable a previously disabled source. Use –all to enable all sources.

thinkt sources enable [source] [flags]

Options#

 --all enable all sources
 -h, --help help for enable

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt sources list

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sources list#

List available session sources

Synopsis#

List all session sources and their availability.

Shows which sources have session data available on this machine.

Sources include:

Kimi Code (~/.kimi)
Claude Code (~/.claude)
Gemini CLI (~/.gemini)
GitHub Copilot (~/.copilot)
Codex CLI (~/.codex)
Qwen Code (~/.qwen)

thinkt sources list [flags]

Options#

 -h, --help help for list

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt sources status

Mon, 01 Jan 0001 00:00:00 +0000

thinkt sources status#

Show detailed source status

Synopsis#

Show detailed information about each session source including workspace ID, base path, and project count.

thinkt sources status [flags]

Options#

 -h, --help help for status

Options inherited from parent commands#

 --json output as JSON
 -v, --verbose verbose output

thinkt teams

Mon, 01 Jan 0001 00:00:00 +0000

thinkt teams#

List and inspect agent teams

Synopsis#

List and inspect multi-agent teams from supported sources.

Teams are groups of AI agents (team lead + teammates) that coordinate via shared task boards and messaging to work on a project together.

Currently supported: Claude Code teams (~/.claude/teams/)

Examples: thinkt teams # List all teams thinkt teams list # Same as above thinkt teams –json # Output as JSON

thinkt teams [flags]

Options#

 --active show only active teams
 -h, --help help for teams
 --inactive show only inactive (historical) teams
 --json output as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt teams list

Mon, 01 Jan 0001 00:00:00 +0000

thinkt teams list#

List all discovered teams

thinkt teams list [flags]

Options#

 -h, --help help for list

Options inherited from parent commands#

 --active show only active teams
 --inactive show only inactive (historical) teams
 --json output as JSON
 -v, --verbose verbose output

thinkt theme

Mon, 01 Jan 0001 00:00:00 +0000

thinkt theme#

Browse and manage TUI themes

Synopsis#

Browse and manage TUI themes.

Running without a subcommand launches the interactive theme browser.

The theme controls colors for conversation blocks, labels, borders, and other UI elements. Themes are stored in ~/.thinkt/themes/.

Examples: thinkt theme # Browse themes interactively thinkt theme show # Show current theme with samples thinkt theme show –json # Output theme as JSON thinkt theme list # List all available themes thinkt theme set dracula # Switch to a theme thinkt theme builder # Interactive theme builder thinkt theme import f.itermcolors # Import iTerm2 color scheme

thinkt theme browse

Mon, 01 Jan 0001 00:00:00 +0000

thinkt theme browse#

Browse and preview themes interactively

Synopsis#

Browse available themes with a live preview.

Navigate themes with arrow keys or j/k, see a live preview of each theme, and activate one with Enter.

Key bindings: ↑/↓ or j/k Navigate themes enter Activate the highlighted theme e Edit the highlighted theme in the builder n Create a new theme in the builder q/esc Quit without changing

thinkt theme browse [flags]

Options#

 -h, --help help for browse

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt theme builder

Mon, 01 Jan 0001 00:00:00 +0000

thinkt theme builder#

Launch interactive theme builder

Synopsis#

Launch an interactive TUI for building and editing themes.

The theme builder shows a live preview of conversation styles and allows editing colors for all theme elements interactively.

If no name is provided, edits a copy of the current theme. If the theme doesn’t exist, creates a new one based on the default.

Examples: thinkt theme builder # Edit current theme thinkt theme builder my-theme # Edit or create my-theme thinkt theme builder dark # Edit the dark theme

thinkt theme import

Mon, 01 Jan 0001 00:00:00 +0000

thinkt theme import#

Import an iTerm2 color scheme as a theme

Synopsis#

Import an iTerm2 .itermcolors file and convert it to a thinkt theme.

The imported theme is saved to ~/.thinkt/themes/ and can be activated with ’thinkt theme set'.

Examples: thinkt theme import ~/Downloads/Dracula.itermcolors thinkt theme import scheme.itermcolors –name my-theme

thinkt theme import <file.itermcolors> [flags]

Options#

 -h, --help help for import
 --name string theme name (default: derived from filename)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt theme list

Mon, 01 Jan 0001 00:00:00 +0000

thinkt theme list#

List all available themes

Synopsis#

List all built-in and user themes. The active theme is marked with *.

thinkt theme list [flags]

Options#

 -h, --help help for list
 --json output as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt theme set

Mon, 01 Jan 0001 00:00:00 +0000

thinkt theme set#

Set the active theme

Synopsis#

Set the active theme by name.

Available built-in themes: dark, light User themes from ~/.thinkt/themes/ are also available.

Examples: thinkt theme set dark thinkt theme set light thinkt theme set my-custom-theme

thinkt theme set <name> [flags]

Options#

 -h, --help help for set

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt theme show

Mon, 01 Jan 0001 00:00:00 +0000

thinkt theme show#

Display a theme with styled samples

Synopsis#

Display a theme with styled samples and a conversation preview.

If no name is provided, shows the active theme.

Examples: thinkt theme show # Show active theme thinkt theme show dracula # Show the dracula theme thinkt theme show –json # Output active theme as JSON

thinkt theme show [name] [flags]

Options#

 -h, --help help for show
 --json output theme as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt tui

Mon, 01 Jan 0001 00:00:00 +0000

thinkt tui#

Launch interactive TUI explorer

Synopsis#

Browse Claude Code conversation sessions in a three-column terminal interface. Navigate projects, sessions, and conversation content with keyboard controls.

Column 1: Project directories Column 2: Sessions with timestamps Column 3: Conversation content with colored blocks

Press T to open thinking-tracer for the selected session.

thinkt tui [flags]

Options#

 -h, --help help for tui
 --log string write debug log to file

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt version

Mon, 01 Jan 0001 00:00:00 +0000

thinkt version#

Print the version information

thinkt version [flags]

Options#

 -h, --help help for version
 --json output as JSON

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt web

Mon, 01 Jan 0001 00:00:00 +0000

thinkt web#

Open the web interface in your browser

Synopsis#

Open the thinkt web interface in your default browser. If the server is not already running, it will be started in the background.

thinkt web [flags]

Options#

 -h, --help help for web
 --host string server host (default "localhost")
 --no-open don't auto-open browser
 -p, --port int server port (default 8784)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt web lite

Mon, 01 Jan 0001 00:00:00 +0000

thinkt web lite#

Open the lightweight web interface

Synopsis#

Open the thinkt lite web interface (debugging and development view).

thinkt web lite [flags]

Options#

 -h, --help help for lite
 --host string server host (default "localhost")
 --no-open don't auto-open browser
 -p, --port int server port (default 8784)

Options inherited from parent commands#

 -v, --verbose verbose output

thinkt

CLI Guide

Command Line Interface#

Quick Start#

Interactive TUI#

Themes

Themes#

Built-in Themes#

dark#

Languages

Languages#

Current Languages#

How to Set Language#

1. Environment Variable#

2. Configuration#

MCP Server

MCP Server#

Overview#

Available Tools#

Lite Interface

Lite Interface#

Quick Start#

Trace Collector

Trace Collector & Exporter#

Architecture#

REST API

REST API#

Quick Start#

Docker

Docker#

Quick Start#

Why Use Docker?#

For LLMs

Guide for AI Assistants#

What is thinkt?#

thinkt

thinkt#

Synopsis#

thinkt agents

thinkt agents#

Synopsis#

thinkt agents follow

thinkt agents follow#

Synopsis#

Options#

Options inherited from parent commands#

SEE ALSO#

thinkt apps

thinkt apps#

Synopsis#

thinkt apps disable

thinkt apps disable#

Options#

Options inherited from parent commands#

SEE ALSO#

thinkt apps enable

thinkt apps enable#

Options#

Options inherited from parent commands#

SEE ALSO#

thinkt apps get-terminal

thinkt apps get-terminal#

Options#

Options inherited from parent commands#

SEE ALSO#

thinkt apps list

thinkt apps list#

Options#

Options inherited from parent commands#

SEE ALSO#

thinkt apps set-terminal

thinkt apps set-terminal#

Synopsis#

Options#

Options inherited from parent commands#

SEE ALSO#

thinkt collect

thinkt collect#

Synopsis#

thinkt collect export-parquet