GitHub - horang-labs/tessera: Tessera — a workspace for organizing AI coding sessions across projects, collections, tabs, panes, and Git worktrees

Keep parallel AI coding work organized.

Tessera helps you run Claude Code, Codex, and OpenCode side by side without losing track of sessions, files, branches, diffs, or pull requests.

Product Demos

Projects, collections, sessions, tabs, and panes

Organize AI coding work by project and collection, then open sessions across persistent tabs and split panes.

Terminal and file tabs

Open agent sessions, terminals, and files as movable tabs so you can reshape the workspace around the work instead of switching tools.

Kanban board workflow

Move implementation work through Todo, Doing, Review, and Done while keeping each task tied to sessions, collections, and worktrees.

Realtime Git worktree tracking

Track each task's worktree, branch, diff, PR state, and workflow status as agents continue working.

Rich composer controls

Open new panels, continue an existing conversation, tune reasoning, select models, choose permissions, use voice input (browser runtime only), add @ references, attach images, and send context-rich prompts from one composer.

Cross-platform agent workspace

Use the same multi-agent workspace in the browser, on macOS, or on Windows while running Claude Code, Codex, OpenCode, and their model choices side by side.

Agent state, tool logs, and diffs

Keep each agent session tied to its task and worktree while tracking tool calls, failures, file changes, diffs, and branch state in real time.

Custom worktree paths

Choose where Tessera creates managed worktrees so agent tasks fit into your existing local development workflow.

Resources

Install

Desktop app

Download from GitHub Releases.

Windows builds are not code-signed yet, so SmartScreen may show an unknown-publisher warning. macOS builds are signed and notarized with Apple Developer ID.

Release downloads, excluding npm installs, as of 2026-05-15 00:28 UTC:

Browser runtime

Requires Node.js 20 or later and npm 10 or later.

npm install -g @horang-labs/tessera
tessera

Open the printed local URL.

Docker Compose

mkdir -p data/config data/local data/ssh data/codex data/tessera workspaces
touch data/gitconfig
docker compose up --build -d

Open http://127.0.0.1:32123. If bind mounts are not writable:

sudo chown -R 1000:1000 data workspaces

First Run

On first run, Tessera guides you through:

1. Creating a local account for the browser runtime.
2. Checking that a supported CLI is installed and authenticated.
3. Selecting a project folder.
4. Starting a chat or worktree-backed task.

Authenticate provider CLIs first, for example with claude login, codex login, or OpenCode's configured provider credentials.

Core Features

Tessera is designed for developers who run multiple AI coding sessions and need more structure than terminal tabs:

Also included: keyboard-first navigation, browser-native voice input through the Web Speech API in the browser runtime, and a Claude Code skills dashboard discovered from the local environment.

Technical Highlights

Tessera is built around a local runtime and provider-based CLI layer:

• Provider adapter architecture: each CLI is isolated behind a CliProvider contract for process lifecycle, protocol parsing, runtime controls, approvals, interrupts, and skills.
• Protocol normalization layer: Claude Code stream-json, Codex app-server, and OpenCode ACP JSON-RPC events are translated into a shared realtime message model.
• Agent workspace model: chats, tasks, collections, workflow states, managed git worktrees, PR state, diffs, provider controls, and interactive prompts are modeled as first-class workspace concepts.
• OpenCode model bridge: Tessera reads OpenCode's model catalog and exposes configured models, providers, and reasoning variants in the workspace.
• Shared local runtime: desktop and browser runtimes share the same local server, provider layer, and configurable app-data directory.

Provider-specific implementation lives under src/lib/cli/providers/. The rest of the app talks to the shared provider contract instead of CLI-specific internals.

Build From Source

For development, clone the repository and install dependencies:

Source development requires Node.js 20 or later and npm 10 or later.

git clone https://github.com/horang-labs/tessera.git
cd tessera
npm install

Tessera uses a custom Node.js server for the Next.js app, WebSocket transport, database initialization, provider bootstrapping, and background pollers. The dev script starts that server:

Supported environment variables:

Desktop release builds use Electron:

Electron build outputs are written under release/.

Stored Data And Privacy

Tessera runs locally and stores app data under ~/.tessera/ by default.

Published npm and desktop builds include anonymous PostHog telemetry for minimal usage measurement, stored in the US region. You can disable telemetry during onboarding or later in Settings.

Telemetry is limited to basic app usage duration. Tessera does not collect click data, detailed usage patterns, prompts, messages, file paths, command output, repository names, or account details.

Provider requests are handled by the Claude Code, Codex, or OpenCode CLIs installed on your machine. Tessera does not replace their authentication, billing, model access, or network behavior.

Tech Stack

Teams And Design Partners

Tessera is currently focused on individual local workflows, but we are preparing team and enterprise features for companies running coding agents across multiple developers.

The team product is being shaped around three areas: shared workspaces for parallel agent work, governance for permissions and tool use, and operational visibility into agent usage, cost, and review state.

If your team wants to use Tessera in production, join the design partner waitlist.

Community And Contributions

Tessera is for developers who run coding agents every day. We welcome focused issues and pull requests from real usage: desktop QA on Windows, macOS, and Linux; Claude Code, Codex, and OpenCode provider edge cases; documentation fixes; UI polish; and workflow reliability improvements.

Start with good first issues or help wanted when they are available. If your change is larger than a focused fix, open a discussion or issue first so we can align on the approach.

Thanks to @jakedev796, Tessera's first external contributor, for helping exercise real Windows and Electron workflows and landing practical fixes in v0.1.4.

Roadmap

Planned areas include:

Troubleshooting

CLI is not detected

Install and authenticate Claude Code, Codex, or OpenCode. If Tessera still cannot find it, open Settings and set the CLI path manually.

Provider stays logged out

Run the provider login command, for example claude login, codex login, or your OpenCode provider setup, then refresh provider status.

Still stuck?

Please open a GitHub Issue with your OS, Tessera version, runtime, provider CLI, and the error you see.

License

Tessera is open source under the Apache License 2.0 (Apache-2.0).

Copyright (c) 2026 Horang Labs, Inc.

See the LICENSE file for the full text.

Claude Code is a trademark of Anthropic. Codex and OpenAI are trademarks of OpenAI. Tessera is not affiliated with or endorsed by Anthropic or OpenAI.