Skip to content

README.md

Latest commit

 

History

History
146 lines (103 loc) · 5.52 KB

README.md

File metadata and controls

146 lines (103 loc) · 5.52 KB
Raw

Threadlines

Threadlines, the open-source workspace for Claude Code and Codex

CI Latest release License: MIT

Website · Download · What's new in v0.3 · Latest release

Threadlines is an open-source desktop workspace for Codex and Claude Code. Keep the agent conversation, a live browser, project files, terminal, and source control open together so you can see, steer, and recover agent work without reconstructing context across tools.

Why Threadlines

  • A browser beside every thread. Review visual changes and send the exact page state back to the agent without leaving the workspace.
  • Source control you can act on. Inspect per-file changes and the commit graph, then commit, push, and open a pull request from the same app.
  • Exact context instead of repeated prompts. Attach selected reply, code, or terminal lines directly to the next message.
  • Nothing runs invisibly. Track tasks, subagents, and background processes, including their live state and stop controls.
  • Durable, provider-flexible sessions. Resume work after restarts and switch between Codex and Claude Code without losing the thread or working tree.

Installation

Warning

Threadlines uses locally installed coding agents. Install and authenticate at least one maintained provider before use:

  • Codex: install Codex CLI and run codex login
  • Claude: install Claude Code and run claude auth login

Desktop app

Install the latest stable desktop app from the download page or GitHub Releases.

Signed Windows and macOS builds and a Linux x64 AppImage are published through the desktop release workflow. Linux builds are unsigned; integrity for auto-updates is verified through the updater manifest hashes.

Then open a local project and start a thread with the provider you already use.

Server CLI

The npm package supports advanced CLI/server and remote-bootstrap usage:

npx @threadlines/server@latest --help

Important

The server requires Node.js 22.22.2+, 24.15+, or 26+. Odd-numbered Node releases are not supported.

Local development

vp install --frozen-lockfile
vp run dev

On Windows, clone the repository outside OneDrive-synced folders (Desktop/Documents by default) — syncing node_modules, .git, and build output noticeably slows installs, builds, and file watching.

Local desktop artifact

vp install --frozen-lockfile
vp run dist:desktop:artifact -- --platform win --target nsis --arch x64 --build-version 0.3.0

The artifact is written to release/.

Supported providers

Codex and Claude Code are the maintained provider paths. Other inherited provider surfaces may remain visible while Threadlines narrows toward a smaller native desktop surface, but they are not actively supported.

Origins

Threadlines began as a fork of T3 Code. It now has its own product direction, branding, desktop release pipeline, provider orchestration, source-control workflow, signing/notarization setup, and compatibility policy.

The upstream Git history and MIT attribution are kept intact.

See docs/fork-separation.md for the current origin and compatibility policy.

Configuration

New configuration should use THREADLINES_* environment variables:

  • new local configuration should use THREADLINES_* environment variables;
  • new installs default to a separate ~/.threadlines data directory;
  • the threadlines CLI is the supported command.

Usage analytics are enabled by default in official builds and can be disabled from Settings. See docs/telemetry.md for what Threadlines collects and what it deliberately does not collect.

Releases

Threadlines keeps the upstream Git history but uses its own app versions starting at 0.0.1.

See docs/release.md for the desktop release workflow, platform status, signing requirements, and auto-update behavior.

Development Notes

This is still early WIP. Expect sharp edges.

Do not commit .env files, tokens, private keys, local app data, customer data, or screenshots containing secrets. See SECURITY_GUARDRAILS.md before publishing code or release artifacts.

Before local development, prepare the environment and install dependencies:

# Optional: only needed if you use mise for dev tool management.
mise install
vp install

Read CONTRIBUTING.md before opening an issue or PR.

Support development

Threadlines is free and open source. Optional sponsorships help cover ongoing development and operating costs such as domains, code signing, CI, and hosted Phone Link infrastructure. See SUPPORT.md for the no-perks sponsorship policy and support channels.