horang-labs/tessera

Tessera — a workspace for organizing AI coding sessions across projects, collections, tabs, panes, and Git worktrees

What is Tessera?

Tessera is a local desktop/web application that lets you run multiple AI‑coding agents (Claude Code, Codex, OpenCode) side‑by‑side while keeping all their state—terminal output, file changes, Git branches, and chat—visible in a single workspace. It adds a Kanban‑style board, split‑pane UI, and mobile remote access so you can coordinate parallel agent tasks without losing context.

Core ideas

Idea How Tessera implements it
Parallel agent sessions Each task gets its own isolated worktree and PTY or GUI session. Agents can run simultaneously without stepping on each other’s Git branches.
Model flexibility You can launch Claude Code, Codex, or OpenCode (or any custom model ID you configure) in the same workspace.
Visible workflow A Kanban board (Chat → Todo → Doing → Review → Done) shows every session, its live terminal/chat view, diffs, and Git status. Drag‑and‑drop moves tasks through the pipeline.
Full Git integration From the same UI you can edit files, stage changes, commit, push, and open pull‑requests, all tied to the worktree that the agent is using.
Mobile remote access Pair a phone in Settings → Remote access to continue PTY or GUI sessions, switch to a chat view, or open file panels from the device.
Local‑only operation Tessera never runs the LLM itself; it calls the already‑installed provider CLIs (e.g., claude, codex) that you have authenticated on your machine.

Main UI components

  • Session list / tabs / split panes – keep any number of active terminals or rich GUI chats open.
  • Chat View – turns a live PTY conversation into a readable thread while the terminal keeps running underneath.
  • Images tab – shows images generated by Codex/OpenCode alongside the prompt that produced them.
  • Kanban board – drag cards to track progress; each card links to its session, worktree, and diff.
  • Settings – add custom model IDs, configure remote‑access pairing, and toggle telemetry.

Typical workflow

  1. Start a session – pick Claude Code, Codex, or OpenCode, choose PTY or GUI mode, optionally set a custom model ID.
  2. Create a worktree – Tessera makes an isolated Git worktree for the task.
  3. Run the agent – the agent writes files, runs commands, and you watch the output in the UI.
  4. Review & commit – inspect diffs, edit files, stage changes, commit, push, and open a PR without leaving Tessera.
  5. Move the card – drag the task through the Kanban stages until it reaches Done.
  6. (Optional) Mobile hand‑off – continue the same session from your phone.

Installation options

Method Steps
Desktop app Download the appropriate installer (.exe, .dmg, or .deb) from the GitHub releases page and run it.
Browser runtime (npm) npm install -g @horang-labs/tessera then tessera. The command prints a local URL (default http://127.0.0.1:32123).
Docker Compose Create the required data directories, then docker compose up --build -d. Access at http://127.0.0.1:32123.
From source Clone the repo, npm install, then npm run dev (Node 20+ required).

Prerequisites

  • Node.js 20 or newer (or Node 22‑26) and npm 10+ for the npm or source builds.
  • The provider CLI you intend to use (e.g., claude, codex, or OpenCode’s CLI) must be installed and logged in (claude login, codex login, …).

Data & privacy

  • All app data lives under ~/.tessera/ by default (settings, worktrees, session history, etc.).
  • Provider requests are sent through the installed CLIs; Tessera does not forward prompts or code to its own servers.
  • Anonymous telemetry (feature usage, CLI operation names, desktop vs. mobile) is shipped but can be disabled during onboarding or later in Settings.

Who is it for?

  • Individual developers who use AI coding assistants and want a richer UI to manage many concurrent tasks.
  • Teams (future roadmap) that need shared workspaces, governance, and analytics for agent‑driven development.

Roadmap highlights

  • Cloud‑based shared workspaces and collaborative review.
  • Enterprise governance (permissions, audit trails, tool‑use policies).
  • Analytics on agent efficiency and cost.
  • Shared “team memory” for recurring workflows.
  • Built‑in lead‑agent that can orchestrate other agents.
  • Native Tessera agent (no external CLI needed).

TL;DR: Tessera is a locally‑run, Electron/Next.js app that turns a set of AI coding agents into a visual, Kanban‑driven workspace. It lets you launch Claude Code, Codex, or OpenCode sessions in isolated Git worktrees, watch their terminal output, edit files, commit, and open PRs—all without leaving the app, and even from a phone.

Related

  • Project
  • Project
  • Project
  • Project