# ThreadPort

> Local-first tool that finds unfinished AI coding tasks, captures their evidence, and prepares a confirmed continuation in Claude or Codex.

ThreadPort is an open-source, local-first tool from Frankie-Xu for moving unfinished AI coding work between agents. It indexes local session logs, records observable work state in a Context Capsule, and prepares a continuation for Claude or Codex. The latest GitHub release is v0.2.1.

## What It Is

ThreadPort defines the Context Capsule v1 format, which records objective, decisions, files, commands, tests, Git identity, evidence, and the next action. A task can move between Claude Code, Codex, Cursor, and Gemini without copying hidden reasoning or silently executing code. It ships as a TypeScript SDK, a CLI, and a local browser workbench.

## How the Workflow Works

The `threadport ui` command starts a loopback workbench. You add an explicit workspace and source directory, refresh the source, and search history. You then create or attach a task, review the observed evidence, and confirm your objective and constraints. `threadport prepare` builds a continuation, and `threadport continue` shows the full context, requires typing CONTINUE, verifies again, and then launches a compatible installed agent. There is no automatic launch or apply mode.

## Evidence and Safety Model

- Adapters for Claude, Codex, Cursor, and Gemini map session traces onto Capsule v1 and do not execute the next action.
- Secrets are redacted heuristically, and portable mode replaces external paths with opaque locators.
- Git fingerprints and workspace snapshots support `threadport verify`, which reports matched, drifted, or unverifiable.
- Historical command results are assessed against their own workspace snapshots, so changed code marks a known outcome as stale.
- Decisions and constraints are kept in a reviewed history with conflict detection.

## Current Status

The README says npm publication is pending authentication, so the GitHub release asset should be installed instead. Real agent and platform certification and external user validation are still pending. Cursor support is a narrowly tested transcript-only import. A demo mode with synthetic data is available. The project needs Node 24 or later and uses the Apache-2.0 license.

## Features
- Context Capsule v1 format with JSON Schema
- Task inbox and searchable history
- Session adapters for Claude, Codex, Cursor, and Gemini
- Incremental local indexing
- Revision-checked task editing
- Reviewed decision and conflict ledger
- Workspace snapshots and verification
- Complete continuation preview with terminal confirmation
- Secret redaction and portable path privacy
- Handoff export as Markdown or JSON
- Control receipt ingestion
- Local-only processing with no telemetry

## Integrations
Claude Code, Codex, Cursor, Gemini, Git

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, DEVELOPER_SDK, CLI

## Pricing
Open Source

## Version
0.2.1

## Links
- Website: https://github.com/Frankie-Xu/threadport
- Documentation: https://github.com/Frankie-Xu/threadport/blob/main/docs/v0.2/README.md
- Repository: https://github.com/Frankie-Xu/threadport
- EveryDev.ai: https://www.everydev.ai/tools/threadport