Documentation
Everything TDE does, written down
Guides and reference for the terminal desktop, the tde CLI, the native apps and My Loop. Start with the quickstart, or jump straight to the section you need.
Getting started
- What is TDEThe terminal desktop, My Loop and the parts that make up TDE.
- QuickstartInstall TDE, walk the first-boot wizard and land on the desktop.
- InstallationEvery install shape: VPS, desktop app, kiosk session, paths and flags.
- UpdatingHow TDE updates itself and how to pin a version.
- Configurationconfig.toml, its sibling files and every setting they carry.
Desktop
- Windows and workspacesThe stacking window manager: drag, snap, workspaces and shortcuts.
- Notch, taskbar and launcherThe always-on desktop chrome and how to drive it.
- Control CenterThe settings app and every panel in it, from Appearance to MCP.
- ThemesTonal Slate, theme switching and ANSI remapping.
- Terminal graphicsImages, pixel rendering and graphics protocol support.
CLI
- CLI overviewThe `tde` command surface and how it is organized.
- Tasks, projects and pipelinesDriving the board from the command line.
- SessionsCreating, listing and attaching to sessions.
- RuntimeThe headless runtime and how commands reach it.
- ShareExposing a session over loopback, Tailscale or a public URL.
- Ask and chatOne-shot questions and interactive chat from a shell.
- Agent APIThe structured command surface agents use to drive apps.
- Code graphStructural code exploration with `tde graph`.
- System commandsDoctor, license, sync, cron and the other maintenance commands.
Sessions
- ConceptsThe detachable desktop host: attaching, detaching and what restores.
- Runtime daemonThe per-user service that keeps work running with no desktop open.
- Resume anywhereCanonical agent sessions across machines, and the cross-machine picker.
- Remote access over SSHAttach to a TDE session with public-key SSH without exposing a shell.
Apps
- Apps overviewThe native app surface and what ships in the box.
- Files, Code and ShellThe everyday trio: browse, edit and run.
- BrowserThe in-desktop browser and its pixel view.
- Email and CalendarMulti-account IMAP mail and the CalDAV calendar it hosts.
- Docs and SheetsDocument and spreadsheet editing, agent-drivable.
- Data appsThe HTTP client, the SQL studio and the Redis browser.
- Inspect API discoveryDiscover project routes, review their provenance and keep Collections in sync.
- TDE TestsDiscover hybrid test runners and run all, failed, changed or affected tests.
- Ops appsProcesses, containers, environments, webhooks and deploys.
- Git, diff and PR reviewReviewing changes without leaving the desktop.
My Loop
- My Loop overviewThe command center: every section of the My Loop window, from the board to costs and quotas.
- Projects and tasksHow work is scoped, filed and tracked.
- Pipeline and stagesStage definitions and how a task moves through them.
- Human gatesWhere a person approves, rejects or redirects the work.
- Agents and personasChoosing an agent, a model and a persona per stage.
- Squads and councilFan-out execution and multi-model review.
- BotsCron and webhook automations owned by the Runtime, not the desktop.
- Brain, decisions and recallDurable memory, approved decision records and project-scoped recall.
- Skills, prompts and deliverablesReusable instructions and the artifacts a stage emits.
- Trackers and intakeBringing issues, messages and requests onto the board.
Web Share
Store
Integrations
Cloud
- Licensing and syncActivating a license and replicating state across devices.
- MachinesProvisioning, reaching and operating managed cloud TDE boxes.
- SandboxesPer-project cloud lanes and the per-task forks that run on them.
- OrganizationsEnterprise roles, shared projects and the owner-only delivery and spend report.
- Brain memoriesBrowsing and searching your replicated memories, and an organization's published knowledge.
- TDE PassCapability lanes, caching, rate limits, resilience and troubleshooting.