BEE ▾ Install
0×0 More ↓

A workspace
your agents extend

Bee runs shells and coding agents side by side, each in its own process with its own permissions. Ask an agent for a tool mid-task and it publishes one into the workspace, right where you work. Windows, apps and history persist. Built on Wippy.

curl -fsSL https://raw.githubusercontent.com/wippyai/bee/main/install.sh | sh

Above: cell-for-cell Bee, scripted in the page. Missed the agent building Test Watch? Replay the scene. Browsers keep some keys, so the buttons send them.

bee $ bee --help

bee                    open the desktop in this project
bee claude [args…]      Claude Code, fullscreen
bee codex [args…]       Codex, fullscreen
bee agy [args…]         Agy, fullscreen
bee update             fetch the current application pack

bee claude -p "make the tests pass"

Agents open fullscreen with the arguments you pass. They must be on PATH.

Every window is a real PTY running as your OS user. Bee owns the workspace around it.

Preferences and app checkpoints survive restart.

bee $ bee apps

>_Terminal

A shell or any installed program. Open several, snap them, maximize one.

SSettings

16 themes, 11 wallpapers, two tab styles. Applies everywhere, persists.

PProcess Manager

Heap, scheduler and run queue, one row per process. End an app from here.

TTest Status

UI checks in a background worker, recorded to the journal. Replay any run.

WTest Watch

Not bundled. Claude Code wrote and published it mid-task when asked for a test window. Any app an agent builds lands here.

bee $ bee features

Windows

  • Floating, maximized, minimized, collapsed
  • Move by title, resize from any edge
  • Snap left or right
  • Rename a window, give it an accent
  • Tabs as labels or icons
  • Start, window and desktop menus

Terminals and agents

  • Native PTY shells
  • Claude Code, Codex and Agy launch fullscreen
  • Agents publish apps into the workspace next
  • Confirmed close, forced stop for stuck apps
  • Dialogs isolated from app input

Workspace and recovery

  • Stable workspace ID in local SQLite
  • Appearance persists per workspace
  • Apps checkpoint and return after restart
  • F12 reloads the UI, every process survives
  • Checked migrations that fail closed

Foundation

  • One process per app, typed launch contract
  • Sender-checked messages, named grants
  • Apps cannot write the registry
  • Local event journal with replay
  • Runtime pinned by commit and checksum
  • Real terminal acceptance tests

bee $ bee roadmap

Agents inside the desktop

  • Agent drivers and MCPnext
    Agents get Bee's tools: windows, threads, questions to you.
  • Hooks and thread observationdesign
    Agents subscribe to workspace events.
  • Local modelslater
    A model on the same machine.

Self-editing workspace

  • Edit an app from inside Beenext
    Draft, validate, review, activate. Known-good boot kept.
  • Hub install and updatein progress
    Pull and publish app packs.
  • Live installationdesign
    Add apps to a running workspace.

Many clients, many workspaces

  • Headless workspace hostin progress
    Boot without a terminal, attach clients later.
  • Remote attachmentdesign
    Same workspace from another machine, your own layout.
  • Workspace manager and switcherdesign
    Projects and hosts from one shell.

Portable work

  • Export and importdesign
    One versioned pack: apps, deps, chosen state.
  • Harnesses in CIproposal
    Same checks headless in GitHub Actions.
  • Durable subscriptionsproposal
    Threads shared across clients.

bee $ bee keys

  • Open the menuF1
  • Switch applicationAlt+Tab
  • Maximize or restoreF11
  • MinimizeAlt+F9
  • Close windowCtrl+W
  • Open applicationCtrl+N
  • Reload the presenter, apps keep runningF12
  • Quit BeeCtrl+Q
  • Move a windowdrag its title
  • Resize a windowdrag an edge or corner
  • Window menuright-click a title or tab
  • Desktop menuright-click the wallpaper

bee $ bee themes

Pick one. The page and the workspace repaint.

bee $ bee install

$ curl -fsSL \
    https://raw.githubusercontent.com/wippyai/bee/main/install.sh \
    | sh
Linux and macOS, amd64 and arm64.

Then bee, or bee claude.

sh install.sh --version 0.3.0
sh install.sh --dir /opt/bee/bin

Pin a release or pick the directory. The script verifies the checksum and copies one file.

git clone https://github.com/wippyai/bee
cd bee && make setup && make check
install -Dm755 dist/bee ~/.local/bin/bee

From source, with the full acceptance suite.

Development preview. Linux amd64 is the tested target.