selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
tessera logo

Self-host tessera

v0.2.4

Workspace for parallel AI coding sessions with Git worktrees

BetaOpen SourceAGPL-3.0
npm install -g @horang-labs/tessera
Updated12 hours ago
LanguageTypescript
Setup difficultyModerate
MobileResponsive
Stars
314
Port
32123 (HTTP server for browser runtime)
Claude Code, Codex, and OpenCode sessions running together in TesseraA lead agent creating and coordinating parallel Tessera sessionsMoving agent tasks through the Tessera Kanban workflowContinuing PTY and GUI sessions from Tessera mobileSwitching between a PTY session and PTY Chat ViewGenerated images and reference inputs beside a Codex terminal sessionEditing files and completing a Git workflow in TesseraRearranging persistent sessions across tabs and split panes

What is tessera?

Tessera is a local workspace that brings AI coding agents together in one place. It runs several agents — Claude Code, Codex, and OpenCode — each inside its own Git worktree so they stay separate. The interface gives you projects, collections, tabs, split panes, and a Kanban board that moves tasks from chat through review to done. You can edit code, see diffs, commit, push branches, and open pull requests all inside the app. A lead agent can coordinate workers through a built-in CLI. Phones pair through a remote-access feature to keep sessions going on the go. Data lives under ~/.tessera/ and requests go through the provider CLIs you already use. Install as a desktop app on Windows, macOS, or Linux, run via npm, or deploy with Docker Compose. Licensed AGPL-3.0; team features are planned.

Should you self-host tessera?

tessera scores 47/100 on selfhost.directory (how scoring works) and ranks #98 of 166 in Developer Tools. It has 314 GitHub stars.

It shipped 15 stable releases in the past year. The latest, v0.2.4, came out on 25 September 2026. New versions land roughly every 6 days.

Setup is moderate: expect some configuration beyond a single command. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is openhands (87/100, 92 105 stars). It scores higher overall, so compare the two before you pick. See tessera vs openhands side by side.

Features

  • Anonymous telemetry (opt-out)Opt-out available
  • Built-in Git workflow
  • Custom model selection
  • Git Worktree Isolation
  • Image generation panel
  • Kanban board for agent tasks
  • Lead agent orchestration
  • Live context tracking
  • Local Data Storage
  • Parallel AI agent sessions
  • Persistent tabs and split panes
  • PTY and GUI modes
  • PTY Chat View

tessera README

How to install tessera

Install tessera with Docker Compose

Environment variables
TESSERA_HOST=0.0.0.0
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

Runs on port 32123

How to configure tessera

  • CLAUDE_CONFIG_DIR~/.claudeOverride the Claude Code config directory used for skill discovery

    Override the Claude Code config directory used for skill discovery

  • LOG_LEVELinfoBackend log level

    Backend log level

    values: debug, info, warn, or error

  • PORT3000 from source, 32123 from the npm CLIHTTP server port for source and npm runs

    HTTP server port for source and npm runs

  • TESSERA_DATA_DIR~/.tesseraApp data root for the database, local users, auth keys, settings, worktrees, attachments, and session history

    App data root for the database, local users, auth keys, settings, worktrees, attachments, and session history

  • TESSERA_HOST127.0.0.1Host interface for source and npm runs. HOST is also accepted by the source server

    Host interface for source and npm runs. HOST is also accepted by the source server

tessera releases & version history

More in Application Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…