Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 25 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,22 @@ auto-updates is verified through the updater manifest hashes.

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

### Self-host with Docker

Run Threadlines on a VPS or home server and connect from any browser or your
phone:

```bash
docker run -d --name threadlines --restart unless-stopped \
-p 3773:3773 \
-v threadlines-home:/home/threadlines \
-v /path/to/your/repos:/workspace \
ghcr.io/threadlines/threadlines:latest
```

See [docker/README.md](./docker/README.md) for the full guide, including phone
pairing and safe remote access.

### Server CLI

The npm package supports advanced CLI/server and remote-bootstrap usage:
Expand Down Expand Up @@ -83,21 +99,21 @@ 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.
Codex and Claude Code are the actively maintained providers today. Drivers for
other agents exist in the codebase, and support for more providers is open for
the future as the product grows.

## Origins

Threadlines began as a fork of [T3 Code](https://github.com/pingdotgg/t3code).
It now has its own product direction, branding, desktop release pipeline,
provider orchestration, source-control workflow, signing/notarization setup, and
compatibility policy.
Threadlines began as a fork of [T3 Code](https://github.com/pingdotgg/t3code)
and has since grown its own product direction, branding, release pipeline,
provider orchestration, and source-control workflow. Upstream remains a source
of inspiration, and improvements flow back when they fit.

The upstream Git history and MIT attribution are kept intact.

See [docs/fork-separation.md](./docs/fork-separation.md) for the current origin
and compatibility policy.
See [docs/fork-separation.md](./docs/fork-separation.md) for the origins and
compatibility policy.

## Configuration

Expand Down
13 changes: 8 additions & 5 deletions docs/fork-separation.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,17 @@
Threadlines began as a fork of [T3 Code](https://github.com/pingdotgg/t3code).
We keep that attribution and upstream history, while Threadlines owns the
product direction, visible app identity, release lane, and compatibility policy.
Upstream remains a source of inspiration, and improvements flow back where they
fit.

## Current Direction

- Threadlines is a local-first desktop app for macOS and Windows, focused on
Codex and Claude Code.
- Codex and Claude are the maintained provider paths.
- Remote, hosted-web, SSH, Tailscale, Cursor, and OpenCode surfaces are being
phased out unless they directly support the desktop workflow.
- Threadlines is a workspace for coding agents that runs where you work: a
desktop app for macOS, Windows, and Linux, a self-hostable server (Docker,
VPS, homelab), a hosted web app, and phone access through device pairing.
- Codex and Claude Code are the actively maintained providers. Drivers for
other agents remain in the codebase and support for more providers is open
for the future.
- Compatibility should prevent old settings from disappearing during upgrades,
but new user-facing guidance should use Threadlines names.

Expand Down
Loading