← Discover MCPs and Agents
t
MCPAI & MLGitHub

tessera

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

Links

README

From the repo.

Tessera

Tessera

Run more agents. Lose less context.

The local control room for Claude Code, Codex, and OpenCode—parallel sessions, isolated worktrees, Kanban, Git, and mobile access in one place.

GitHub stars npm Node.js 20 or later License: AGPL-3.0

Download Tessera · Run with npm

Claude Code, Codex, and OpenCode sessions running together in Tessera

One workspace for the entire agent loop

Tessera turns a pile of terminals into a visible workflow. Give each task its own session and isolated worktree, follow every agent without hunting through windows, and take the result all the way to a pull request.

  • Delegate in parallel — run independent tasks without agents stepping on the same branch.
  • Use the right agent and model — mix Claude Code, Codex, and OpenCode in PTY or GUI mode, including custom model IDs.
  • Keep every session within reach — move between list, board, tabs, split panes, and your phone without losing the conversation.
  • Finish where the work happened — inspect files and diffs, commit, sync, publish branches, and open pull requests from Tessera.

[!NOTE] Tessera runs locally and uses the provider CLIs already installed and authenticated on your machine.

Let the lead agent run the workspace

Invoke /tessera-cli inside a managed Claude Code, Codex, or OpenCode session. A lead agent can create isolated worktrees, launch parallel sessions, wait for results, inspect their output, and send follow-up prompts—while every worker stays visible in Tessera.

Representative operations: status · worktree create · session launch · session wait / session read · session prompt

A lead agent creating and coordinating parallel Tessera sessions

Turn parallel sessions into a delivery pipeline

The Kanban board tracks direct chats and worktree-backed tasks across Chat, Todo, Doing, Review, and Done. Move cards as work progresses, see live agent and diff state, and open the linked PTY or GUI session without leaving the board.

Moving agent tasks through the Tessera Kanban workflow

Keep coding from your phone

Pair a device from Settings → Remote access. Continue PTY and GUI sessions, switch a PTY into Chat View, and open the session or Files/Git panels from mobile.

Continuing PTY and GUI sessions from Tessera mobile

PTY speed, chat readability

Open a Codex or OpenCode PTY and press the chat icon in its header. Chat View turns the live terminal conversation into a focused, readable thread without stopping the PTY underneath.

Switching between a PTY session and PTY Chat View

Create and refine images without leaving the session

Open the Images tab in a Codex terminal session to see generated images, their reference inputs, and prompts together. Download a result or drag it into your next prompt.

Generated images and reference inputs beside a Codex terminal session

Finish the Git workflow without switching apps

Edit project files, review diffs, select changes, commit, sync, publish branches, and open pull requests without leaving the session.

Editing files and completing a Git workflow in Tessera

Built for real-world agent work

Built forWhat you get
Claude Code, Codex, and OpenCodeStart any supported provider in PTY or rich GUI mode and keep its conversation, tools, and state visible.
Projects and sessionsCollections, persistent tabs, split panes, list view, and a task-aware Kanban board.
Terminal and GUIRun PTY sessions and rich conversations side by side in the same workspace.
Custom modelsAdd custom model IDs in Settings and select them when starting a session.
Live contextFollow tool calls, failures, instructions, memory, file changes, diffs, and branch state.
Task-aware GitKeep tasks, sessions, worktrees, and pull requests connected from start to finish.

Rearranging persistent sessions across tabs and split panes

Install

Desktop app

Download from GitHub Releases.

PlatformAsset
Windows, including WSLPortable .exe
macOS.dmg for Apple Silicon or Intel
Linux beta.deb

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.

Browser runtime

Requires Node.js 20.9+ (20.x) or Node.js 22–26, plus 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.

Build From Source

For development, clone the repository and install dependencies:

Source development requires Node.js 20.9+ (20.x) or Node.js 22–26, plus 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:

npm run dev

Supported environment variables:

VariableDefaultPurpose
TESSERA_DATA_DIR~/.tesseraApp data root for the database, local users, auth keys, settings, worktrees, attachments, and session history
PORT3000 from source, 32123 from the npm CLIHTTP server port for source and npm runs
TESSERA_HOST127.0.0.1Host interface for source and npm runs. HOST is also accepted by the source server
LOG_LEVELinfoBackend log level: debug, info, warn, or error
CLAUDE_CONFIG_DIR~/.claudeOverride the Claude Code config directory used for skill discovery

Desktop release builds use Electron:

TargetCommand
Windows portable .exenpm run electron:build:win
macOS Apple Silicon dev .dmgnpm run electron:build:mac-arm64

Electron build outputs are written under release/.

Stored Data And Privacy

Tessera runs locally, stores app data under ~/.tessera/ by default, and sends provider requests through the Claude Code, Codex, or OpenCode CLI installed on your machine.

Published builds include anonymous product-interaction telemetry that you can disable during onboarding or in Settings. This includes which named controls and features are used, anonymous Tessera CLI operation names, and a coarse mobile-or-desktop classification computed locally, but never visible UI text, prompts, messages, CLI arguments, file paths, command output, repository names, raw device details, or account details.

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.

Roadmap

Planned areas include:

AreaDirection
Cloud team collaborationShared projects, team-visible task state, and collaborative review workflows
Enterprise governancePermission management, tool-use policies, audit trails, and controls for blocked or unapproved agent actions
Agent operations analyticsVisibility into agent efficiency, model/provider usage, and cost patterns across a team workspace
Team memoryShared project context and team-specific agent memory for recurring workflows
Multi-agent collaborationA lead agent that coordinates task creation, review, Git workflow management, and parallel worker agents
Tessera-native agentA built-in agent experience in addition to external CLI providers
Web debuggingBrowser inspection, logs, screenshots, and frontend debugging context

License

Tessera is open source under the GNU Affero General Public License v3.0 (AGPL-3.0).

Copyright (c) 2026 Horang Labs, Inc.

See the LICENSE file for the full text.

Collected info

  • ★ 311 stars
  • ⎇ 27 forks
  • Language: TypeScript
  • Source updated: 9/23/2026

Config for your environment

Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.

Tool

OS

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "{MCP_ENDPOINT_URL}"
    }
  }
}

Paste into mcpServers in the config file. Restart Cursor after saving.

If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.