Skip to content
WorktreeOS

Repository layout

WorktreeOS is organized as a Bun monorepo (workspaces: ["apps/*", "packages/*"]).

Apps

Section titled “Apps”
  • apps/cli — the CLI (@worktreeos/cli); contains bin/wos and the index.ts entry point. The CLI is a launcher and a text-based status tool on top of the daemon; the interactive UI is no longer part of the CLI.
  • apps/web — the React frontend (@worktreeos/web), built with Bun’s bundler from index.html. The web UI is the main interface for observing deployments.
  • apps/docs — this Astro Starlight documentation site (@worktreeos/docs).

Packages

Section titled “Packages”
  • packages/core — configuration, paths, state, events, git/worktree, project-name, session-context.
  • packages/compose — Compose generation, runner, ps parser, host-port allocator.
  • packages/runtime — orchestration (runUpProgram, runDownOperation, …), setup, caches, healthchecks, tunnels, service logs.
  • packages/daemon — daemon server/client/protocol, operation registry, web listener.
  • packages/ui — formatting, log-format, host-link, and text renderers (plainRenderer, detachedRenderer).
  • packages/skills — the AI skills catalog.
Section titled “Related”