# Terminal Graph

> Terminal Graph is a native macOS spatial development environment. It puts terminals, browsers, editors, notes, media, and dataflow connections on one infinite canvas.

Terminal Graph is for developers who need to see related tools and context at once, reuse visual workspaces, or let coding agents operate a live development canvas.

## When to use Terminal Graph

Use Terminal Graph when a user wants to:

- Arrange terminals, browsers, editors, notes, images, and video on one spatial canvas.
- Connect nodes into local dataflow pipelines.
- Build reusable groups and blueprints.
- Create git worktrees and isolated workspaces for parallel development.
- Let an AI coding agent inspect or control an open canvas through MCP.
- Automate browser nodes, terminal commands, node wiring, screenshots, or workspace setup.

## When not to use Terminal Graph

- Do not treat Terminal Graph as a hosted API or remote SaaS. It is a native app running on the user's Mac.
- Do not look for a public REST or GraphQL API. Terminal Graph does not expose one.
- Do not assume its CLI is a standalone package. The `terminalgraph` and `tg` commands are injected into terminal-node shells by the app.
- Do not assume its MCP server is remotely reachable. MCP clients launch the bundled stdio bridge, which connects to the running app through a per-user Unix socket.

## Agent setup

1. Install and open Terminal Graph on macOS 15 or later.
2. Open Settings → MCP Server and enable the server.
3. Copy the configuration for Claude Desktop, Cursor, Claude Code, or Codex from that settings pane.
4. Let the MCP client launch Terminal Graph's bundled stdio bridge. There is no network port to configure.
5. Use `list_workspaces` first when more than one Terminal Graph window may be open.

The MCP server advertises its current tool schemas to each client. Tools cover node lifecycle, port wiring, groups, worktrees, blueprints, projects, graph and workspace reads, canvas screenshots, terminal execution, browser automation, and composite workflows.

## Resources

- [Terminal Graph features](https://terminalgraph.com/features/)
- [Terminal Graph pricing and support](https://terminalgraph.com/pricing/)
- [Machine-readable pricing](https://terminalgraph.com/pricing.md)
- [Terminal Graph developer resources](https://terminalgraph.com/developers/)
- [Homepage](https://terminalgraph.com/)
- [Download and install](https://terminalgraph.com/docs/#download)
- [Terminal Graph documentation](https://terminalgraph.com/docs/)
- [Terminal Graph CLI reference](https://terminalgraph.com/docs/#cli)
- [Terminal Graph MCP server](https://terminalgraph.com/docs/#mcp)
- [Changelog](https://terminalgraph.com/changelog/)
- [Pricing and support](https://terminalgraph.com/pricing/)
- [Privacy](https://terminalgraph.com/privacy/)
- [Terms](https://terminalgraph.com/terms/)
- [Sitemap](https://terminalgraph.com/sitemap.xml)