thinkt VS Code Extension
Browse and search AI conversation traces from Claude Code, Kimi Code, Gemini, Codex, Copilot, Qwen, and other sources directly inside VS Code.
The extension talks to the local or remote thinkt HTTP server and can also manage a local thinkt install for you.
Features
- Dedicated Thinkt activity bar with native Projects, Search, Current Project, and Sources views
- Grouped Projects tree that merges sessions across sources
- Native Search sidebar with text and semantic search
- Rich session viewer webview for opening individual traces
- Hosted Thinkt Web and Thinkt Web Lite tabs inside VS Code
- Local server discovery, start/stop, download, uninstall, and output channels
- Shared multi-source filtering across Projects and Search
- Native VS Code localization and welcome/setup states
Requirements
- VS Code
1.108.1 or newer
- A local or remote
thinkt server
Installation
Managed local install
If thinkt is not already installed, the extension can download it into VS Code-managed storage.
After download, the extension runs:
thinkt setup
in an integrated terminal. The terminal closes automatically when setup completes successfully.
Manual install
go install github.com/wethinkt/go-thinkt/cmd/thinkt@latest
or install it from the GitHub releases page:
https://github.com/wethinkt/go-thinkt/releases
Configuration
| Setting |
Default |
Description |
thinkt.serverUrl |
http://localhost:8784 |
thinkt server base URL |
thinkt.apiToken |
"" |
Optional API token override |
thinkt.timeout |
30000 |
Request timeout in milliseconds |
thinkt.binaryPath |
"" |
Optional custom thinkt binary path |
thinkt.indexerBinaryPath |
"" |
Optional custom thinkt-indexer binary path |
thinkt.autoStart |
true |
Auto-start the local thinkt server in the background on activation |
thinkt.defaultPageSize |
50 |
Default page size for session content |
Authentication
For normal local use, leave thinkt.apiToken empty.
Token resolution is:
- SecretStorage token set by
Thinkt: Set API Token
- Non-empty
thinkt.apiToken
- Otherwise, for local servers, the extension asks the local
thinkt binary for the active server token
That means thinkt.apiToken = "" is treated as unset, and the extension should fall back to the local server token automatically.
Usage
Open the Thinkt activity bar icon to access:
- Projects: aggregated projects across sources, with merged session lists
- Search: text and semantic search across indexed sessions
- Current Project: sessions for the currently open workspace folder
- Sources: hierarchical source → project → session browsing
Status bar
The Thinkt status bar item opens a quick menu for:
- server start/stop/restart
- indexer start/stop
- quick pick session
- settings
- server and indexer output
Managed server behavior
- If
thinkt.autoStart is enabled, the extension attempts to start the local server in the background on activation
- If a local server is already running, the extension reconnects instead of treating that as a failure
- The managed server can outlive the VS Code window because
thinkt server start behaves like a launcher for the real server process
Install and uninstall
Thinkt: Download thinkt downloads a managed local install with progress reporting
Thinkt: Uninstall Managed thinkt stops managed server/indexer processes first, then removes the managed install
- If no VS Code-managed install exists, uninstall exits cleanly with an informational message
Commands
Main commands
Thinkt: Refresh
Thinkt: Quick Pick Session
Thinkt: Open Settings
Thinkt: Set API Token
Thinkt: Configure MCP Server
Server and indexer
Thinkt: Start Server
Thinkt: Stop Server
Thinkt: Restart Server
Thinkt: Download thinkt
Thinkt: Uninstall Managed thinkt
Thinkt: Show Server Output
Thinkt: Start Indexer
Thinkt: Stop Indexer
Thinkt: Show Indexer Output
Views and apps
Thinkt: Open Thinkt Web
Thinkt: Open Thinkt Web Lite
Thinkt: Filter Sources
Thinkt: Clear Source Filter
Search
The Search view supports:
- Text search with optional case-sensitive and regex matching
- Semantic search
- shared source filtering with the Projects view
- optional project-name filtering
Session Viewer
Opening a session launches a webview panel with:
- role-aware entry rendering
- markdown and content block rendering
- lazy loading
- session metadata
MCP
The extension can configure a thinkt MCP server entry for VS Code tools via:
Thinkt: Configure MCP Server
This is separate from the extension’s own HTTP API usage.
Development
git submodule update --init --recursive
npm install
npm run compile
npm run lint
The packaged Thinkt Web assets are vendored from the thinkt-web and thinkt-web-lite repositories as git submodules under vendor/, each pinned to its dist branch. Fresh clones and CI packaging need submodules initialized before building or packaging the extension.
To package the extension locally:
npm run vsce:package
Project