Podium

An infinite spatial canvas for terminal windows running AI coding agents.

Drop Claude Code, Codex, OpenCode — or plain shells — onto a zoomable canvas, wire them together, and let agents pipe prompts into each other. Add markdown sticky notes to capture output. No built-in AI: Podium orchestrates the CLI agents you already have installed.

English · Português (BR)

---

What is Podium?

Most terminal multiplexers give you tabs and splits. Podium gives you an infinite 2D canvas. Each terminal is a node you can drag, resize, rename, and connect. Because AI coding agents run as CLIs, you can:

• Run many agents side by side and watch them work in parallel.
• Connect a terminal to another terminal — the source agent's last output is wrapped in a handoff template and piped straight into the target agent's stdin. Agent-to-agent handoff, no copy-paste.
• Connect a terminal to a note to capture its output as timestamped markdown.
• Zoom out to see the whole orchestra; zoom in to drive a single agent.

It's a workspace for people who run more than one agent at a time and want to see the whole thing.

Features

🖥️ Real terminals	Full PTY round-trip via portable-pty — typing, colors, resize, Ctrl+C, arrows. Launch claude, codex, opencode, or any shell.
♾️ Infinite canvas	Pan, zoom, drag. Built on React Flow. Drag nodes by their header only.
🔗 Connections	Animated arrow edges. Terminal→terminal and terminal→note. Double-click an edge to delete.
🤝 Agent-to-agent handoff	Toggle allowIncoming per node. Delegate wraps the source's last output in a handoff prompt and writes it to allowed targets.
📝 Markdown notes	Dependency-free renderer (no HTML injection). Capture → note appends the last 20 lines, timestamped.
💬 Prompt broadcast	Footer input pipes a prompt into every connected terminal's stdin at once.
💾 Persistence	Workspace saved as plain JSON in the app data dir. Debounced auto-save. No database.
🪟 Cross-platform	Windows (ConPTY) · macOS · Linux (openpty). One codebase, native bundles for all three: .msi/.exe, .dmg/.app, and .deb/.rpm/.AppImage.

Stack

• Tauri 2 (Rust backend) + React 18 + TypeScript (strict) + Vite
• xterm.js (@xterm/xterm + fit + webgl addons)
• portable-pty — ConPTY on Windows, openpty on Unix
• zustand for frontend state
• React Flow (@xyflow/react) for the canvas
• Persistence: plain JSON in Tauri's app_data_dir — no database

Getting started

Download (no build required)

Grab a ready-to-run installer from the Releases page:

OS	File	Notes
Windows	.msi or .exe	Run the installer.
macOS	.dmg	Universal (Apple Silicon + Intel). Unsigned build — first launch: right-click → Open.
Linux	.AppImage	chmod +x Podium_*.AppImage && ./Podium_*.AppImage — no install needed.
Linux	.deb / .rpm	sudo apt install ./Podium_*.deb (or dnf install).

No release yet? Build it yourself in one command — see Build a release binary below.

If you want to explore the code, contribute, or run the latest unreleased version, follow the steps below.

Prerequisites

• Node.js 18+
• Rust (stable) + the Tauri prerequisites for your OS
• At least one AI CLI agent installed if you want to drive one (e.g. Claude Code)

Linux system dependencies

Tauri renders through your system's WebKitGTK webview, so Linux needs a few dev libraries. On Debian/Ubuntu:

sudo apt-get update
sudo apt-get install -y \
  libwebkit2gtk-4.1-dev \
  libappindicator3-dev \
  librsvg2-dev \
  patchelf \
  libgtk-3-dev \
  libssl-dev

• Fedora: sudo dnf install webkit2gtk4.1-devel gtk3-devel libappindicator-gtk3-devel librsvg2-devel patchelf openssl-devel
• Arch: sudo pacman -S webkit2gtk-4.1 gtk3 libappindicator-gtk3 librsvg patchelf openssl

Both X11 and Wayland are supported (WebKitGTK picks the right backend). See the Tauri Linux guide if your distro differs.

Run in development

git clone https://github.com/abrahao-dev/podium-app.git
cd podium-app
npm install
npm run tauri dev

Build a release binary

npm run tauri build

Tauri bundles for the OS you build on (cross-compilation isn't automatic). Outputs land in src-tauri/target/release/bundle/:

OS	Artifacts
Windows	.msi (WiX) and .exe (NSIS) installers
macOS	.app bundle and .dmg
Linux	.deb, .rpm, and .AppImage

Pre-built binaries for all three platforms are produced on every push by the CI workflow.

Usage

1. + Terminal in the top toolbar spawns a new terminal node. Type claude (or any agent CLI) and hit enter.
2. + Note drops a markdown sticky note.
3. Drag from a terminal's right handle to another terminal's left handle to connect them.
4. Use the footer prompt to broadcast a prompt to all connected terminals.
5. Toggle the header ⊘ / ⇥ to allow a node to receive agent-to-agent handoffs.
6. Your layout auto-saves — reopen and pick up where you left off. Restored terminals show a Start overlay and never auto-run a command.

Project status

Podium is built in phases. Current state:

• Phase 1 — Skeleton + one working terminal (full PTY round-trip, claude launchable)
• Phase 2 — Multiple terminals + notes + persistence
• Phase 3 — Connections (handles, edges, prompt broadcast, capture)
• Phase 4 — Agent-to-agent handoff
• Phase 5 — Windows pass (ConPTY quirks)

Note: This is an early-stage MVP. It's the author's first open-source project — issues, ideas, and PRs are very welcome. 🙌

Contributing

Contributions are welcome! A few ground rules that keep the codebase healthy:

• TypeScript strict, no any. cargo clippy must stay clean.
• All platform-specific Rust lives in src-tauri/src/pty.rs — nowhere else.
• Windows, macOS, and Linux must all work at all times. Use Tauri path APIs; write \r (not \n) to submit input to PTYs.
• Conventional commits. Every change should keep the app launching.

Open an issue to discuss anything non-trivial before a large PR.

License

MIT © 2026 Matheus Abrahão

---

---

Podium — Português (BR)

Um canvas espacial infinito para janelas de terminal rodando agentes de IA para código.

English · Português (BR)

O que é o Podium?

A maioria dos multiplexadores de terminal te dá abas e splits. O Podium te dá um canvas 2D infinito. Cada terminal é um nó que você pode arrastar, redimensionar, renomear e conectar. Como agentes de IA para código rodam como CLIs, você pode:

• Rodar vários agentes lado a lado e vê-los trabalhar em paralelo.
• Conectar um terminal a outro terminal — a última saída do agente de origem é embrulhada num template de handoff e enviada direto para o stdin do agente de destino. Handoff agente-para-agente, sem copiar e colar.
• Conectar um terminal a uma nota para capturar sua saída como markdown com data/hora.
• Dar zoom out para ver a orquestra inteira; zoom in para operar um único agente.

É um espaço de trabalho para quem roda mais de um agente ao mesmo tempo e quer enxergar tudo.

Funcionalidades

🖥️ Terminais de verdade	PTY completo via portable-pty — digitação, cores, resize, Ctrl+C, setas. Rode claude, codex, opencode ou qualquer shell.
♾️ Canvas infinito	Pan, zoom, arrastar. Construído com React Flow. Nós são arrastados só pelo cabeçalho.
🔗 Conexões	Arestas animadas com seta. Terminal→terminal e terminal→nota. Duplo-clique numa aresta apaga.
🤝 Handoff agente-para-agente	Toggle allowIncoming por nó. Delegar embrulha a última saída da origem num prompt de handoff e escreve nos destinos permitidos.
📝 Notas markdown	Renderizador sem dependências (sem injeção de HTML). Capturar → a nota adiciona as últimas 20 linhas com data/hora.
💬 Broadcast de prompt	Input do rodapé envia um prompt para o stdin de todos os terminais conectados de uma vez.
💾 Persistência	Workspace salvo como JSON puro no diretório de dados do app. Auto-save com debounce. Sem banco de dados.
🪟 Multiplataforma	Windows (ConPTY) · macOS · Linux (openpty). Um só código, bundles nativos para os três: .msi/.exe, .dmg/.app e .deb/.rpm/.AppImage.

Stack

• Tauri 2 (backend em Rust) + React 18 + TypeScript (strict) + Vite
• xterm.js (@xterm/xterm + addons fit e webgl)
• portable-pty — ConPTY no Windows, openpty no Unix
• zustand para estado no frontend
• React Flow (@xyflow/react) para o canvas
• Persistência: JSON puro no app_data_dir do Tauri — sem banco de dados

Começando

Baixar (sem compilar)

Pegue um instalador pronto na página de Releases:

SO	Arquivo	Observações
Windows	.msi ou .exe	Rode o instalador.
macOS	.dmg	Universal (Apple Silicon + Intel). Build sem assinatura — na 1ª vez: clique direito → Abrir.
Linux	.AppImage	chmod +x Podium_*.AppImage && ./Podium_*.AppImage — não precisa instalar.
Linux	.deb / .rpm	sudo apt install ./Podium_*.deb (ou dnf install).

Ainda sem release? Compile você mesmo com um comando — veja Gerar binário de release abaixo.

Se quiser explorar o código, contribuir ou rodar a última versão não publicada, siga os passos abaixo.

Pré-requisitos

• Node.js 18+
• Rust (stable) + os pré-requisitos do Tauri para o seu SO
• Pelo menos um agente CLI de IA instalado, se quiser operar um (ex.: Claude Code)

Dependências de sistema no Linux

O Tauri renderiza pela webview WebKitGTK do sistema, então o Linux precisa de algumas bibliotecas de desenvolvimento. No Debian/Ubuntu:

sudo apt-get update
sudo apt-get install -y \
  libwebkit2gtk-4.1-dev \
  libappindicator3-dev \
  librsvg2-dev \
  patchelf \
  libgtk-3-dev \
  libssl-dev

• Fedora: sudo dnf install webkit2gtk4.1-devel gtk3-devel libappindicator-gtk3-devel librsvg2-devel patchelf openssl-devel
• Arch: sudo pacman -S webkit2gtk-4.1 gtk3 libappindicator-gtk3 librsvg patchelf openssl

X11 e Wayland são suportados (o WebKitGTK escolhe o backend certo). Veja o guia Linux do Tauri se sua distro for diferente.

Rodar em desenvolvimento

git clone https://github.com/abrahao-dev/podium-app.git
cd podium-app
npm install
npm run tauri dev

Gerar binário de release

npm run tauri build

O Tauri empacota para o SO em que você compila (não há cross-compile automático). As saídas ficam em src-tauri/target/release/bundle/:

SO	Artefatos
Windows	Instaladores .msi (WiX) e .exe (NSIS)
macOS	Bundle .app e .dmg
Linux	.deb, .rpm e .AppImage

Binários prontos para as três plataformas são gerados a cada push pelo workflow de CI.

Como usar

1. + Terminal na barra superior cria um novo nó de terminal. Digite claude (ou qualquer CLI de agente) e dê enter.
2. + Note cria uma nota markdown.
3. Arraste do handle direito de um terminal até o handle esquerdo de outro para conectá-los.
4. Use o prompt do rodapé para enviar um prompt a todos os terminais conectados.
5. Alterne o ⊘ / ⇥ no cabeçalho para permitir que um nó receba handoffs agente-para-agente.
6. Seu layout tem auto-save — reabra e continue de onde parou. Terminais restaurados mostram um overlay Start e nunca rodam um comando automaticamente.

Status do projeto

O Podium é construído em fases. Estado atual:

• Fase 1 — Esqueleto + um terminal funcionando (PTY completo, claude executável)
• Fase 2 — Múltiplos terminais + notas + persistência
• Fase 3 — Conexões (handles, arestas, broadcast de prompt, captura)
• Fase 4 — Handoff agente-para-agente
• Fase 5 — Ajustes para Windows (particularidades do ConPTY)

Nota: É um MVP em estágio inicial. É o primeiro projeto open source do autor — issues, ideias e PRs são muito bem-vindos. 🙌

Contribuindo

Contribuições são bem-vindas! Algumas regras que mantêm o código saudável:

• TypeScript strict, sem any. cargo clippy precisa ficar limpo.
• Todo código Rust específico de plataforma vive em src-tauri/src/pty.rs — em nenhum outro lugar.
• Windows, macOS e Linux precisam funcionar sempre. Use as APIs de path do Tauri; escreva \r (não \n) para submeter input a PTYs.
• Conventional commits. Toda mudança deve manter o app iniciando.

Abra uma issue para discutir algo não trivial antes de um PR grande.

Licença

MIT © 2026 Matheus Abrahão