Ctk

Conversation Toolkit (CTK)

A plugin-based system for managing AI conversations from multiple providers. Import, store, search, branch, and export your conversations in a unified tree format while preserving provider-specific details.

Quick Start

# Setup (one-time)
make install

# Import conversations from any supported provider
ctk import chatgpt_export.json --db my_chats
ctk import claude_export.json   --db my_chats --format anthropic

# Open the TUI on the database (primary interface)
ctk --db my_chats

# Bulk-export for fine-tuning, archiving, or sharing
ctk export training.jsonl --db my_chats --format jsonl

`ctk` with no subcommand opens the full-screen Textual TUI on the database in `~/.ctk/config.json`'s `database.default_path` (or the path passed via `--db`). Everything an interactive user does (chat, search, branch trees, organize, edit) lives in the TUI. The CLI subcommands are kept small and scriptable: import, export, query, sql, and a handful of admin operations.

Key Features

• Universal Tree Format: every conversation is a tree. Linear chats are single-path trees, branching conversations (e.g., ChatGPT regenerations) preserve all paths.
• Tree Primitive Algebra: six primitives (delete, delete_subtree, prune_to, copy, copy_subtree, graft) compose into every higher-level operation: fork, branch, clone, snapshot, detach, promote.
• Plugin Architecture: importers and exporters auto-discover via Python imports. Adding a new format is one file.
• Multiple LLM Backends: named provider profiles for OpenAI, Azure, OpenRouter, vLLM, llama.cpp, LM Studio, Ollama, or any other OpenAI-compatible endpoint. Switch live via /provider in the TUI.
• Inline Images: terminal image rendering via textual-image (Sixel, Kitty TGP, or Halfcell), automatic protocol detection.
• Tool Calling / MCP: tools group under named virtual MCP providers (ctk.builtin, ctk.network). The LLM can search, list, find similar conversations