Chapter 7: Runtime and Package Architecture

Welcome to Chapter 7: Runtime and Package Architecture. In this part of Superset Terminal Tutorial: Command Center for Parallel Coding Agents, you will build an intuitive mental model first, then move into concrete implementation details and practical production tradeoffs.

Superset separates desktop runtime concerns and shared agent-execution logic into modular packages.

Architecture Surfaces

Surface	Purpose
desktop runtime	workspace/session lifecycle, notifications, terminal hosting
CLI orchestration	workspace command and state operations
shared @superset/agent package	common agent execution logic across environments

Source References

• Shared agent package docs
• Desktop main runtime modules

Summary

You now have a contributor-level map of Superset runtime boundaries.

Next: Chapter 8: Production Team Operations

Source Code Walkthrough

bunfig.toml

The bunfig module in bunfig.toml handles a key part of this chapter's functionality:

[install]
linker = "isolated" # Prevent hoisting from resolving `path-scurry@2` to `lru-cache@6` (missing `LRUCache`), which breaks the `@superset/desktop` postinstall native rebuild.

This module is important because it defines how Superset Terminal Tutorial: Command Center for Parallel Coding Agents implements the patterns covered in this chapter.

.codex/config.toml

The config module in .codex/config.toml handles a key part of this chapter's functionality:

[mcp_servers.superset]
type = "sse"
url = "https://api.superset.sh/api/agent/mcp"

[mcp_servers.expo-mcp]
type = "sse"
url = "https://mcp.expo.dev/mcp"
enabled = false

[mcp_servers.maestro]
command = "maestro"
args = ["mcp"]

[mcp_servers.neon]
type = "sse"
url = "https://mcp.neon.tech/mcp"

[mcp_servers.linear]
type = "sse"
url = "https://mcp.linear.app/mcp"

[mcp_servers.sentry]
type = "sse"
url = "https://mcp.sentry.dev/mcp"


[mcp_servers.desktop-automation]
command = "bun"
args = ["run", "packages/desktop-mcp/src/bin.ts"]

This module is important because it defines how Superset Terminal Tutorial: Command Center for Parallel Coding Agents implements the patterns covered in this chapter.

.mcp.json

The .mcp module in .mcp.json handles a key part of this chapter's functionality:

{
	"mcpServers": {
		"superset": {
			"type": "http",
			"url": "https://api.superset.sh/api/agent/mcp"
		},
		"expo-mcp": {
			"type": "http",
			"url": "https://mcp.expo.dev/mcp",
			"enabled": false
		},
		"maestro": {
			"command": "maestro",
			"args": ["mcp"]
		},
		"neon": {
			"type": "http",
			"url": "https://mcp.neon.tech/mcp"
		},
		"linear": {
			"type": "http",
			"url": "https://mcp.linear.app/mcp"
		},
		"sentry": {
			"type": "http",
			"url": "https://mcp.sentry.dev/mcp"
		},
		"posthog": {
			"type": "http",
			"url": "https://mcp.posthog.com/mcp"
		},
		"desktop-automation": {
			"command": "bun",
			"args": ["run", "packages/desktop-mcp/src/bin.ts"]
		}

This module is important because it defines how Superset Terminal Tutorial: Command Center for Parallel Coding Agents implements the patterns covered in this chapter.

How These Components Connect

flowchart TD
    A[bunfig]
    B[config]
    C[.mcp]
    A --> B
    B --> C