Skip to main content

CLI Overview

The T3x CLI is an interactive shell for semantic version control of AI conversations.

Installation​

cd contextflow-cli
npm install
npm link  # Makes 'T3x' available globally

Starting the CLI​

T3x

You'll see the interactive prompt:

T3x>

Modes​

The CLI has two modes:

Chat Mode (default)​

For conversations and version control commands.

T3x> Hello, help me plan a trip to Japan
T3x> /turns
T3x> /commit --api --msg "Initial research"

Config Mode​

For setting up API keys and preferences.

T3x> /config
config> /api sk-ant-your-key
config> /model claude-sonnet-4-20250514
config> /back
T3x>

Command Syntax​

  • Slash commands start with /
  • Chat messages are anything else
  • Options use --flag or --flag value
/command [args] [--options]

Quick Reference​

CommandDescription
/new NAMECreate project
/projectList/switch projects
/turnsList turns
/commitCreate commit
/branchManage branches
/diffCompare commits
/statusShow statistics
/helpShow all commands

Configuration​

Settings stored in ~/.contextflow/config.json:

{
  "anthropic_api_key": "sk-ant-...",
  "default_model": "claude-sonnet-4-20250514",
  "stream": true,
  "proxy": null
}

Data Storage​

  • Config: ~/.contextflow/config.json
  • Conversations: .contextflow/conversations/<project>/conversation.jsonl
  • Local cache: SQLite database (optional)

Next Steps​