Skip to content

07-runtime-and-package-architecture.md

Latest commit

 

History

History
142 lines (105 loc) · 3.81 KB

07-runtime-and-package-architecture.md

File metadata and controls

142 lines (105 loc) · 3.81 KB
layout default
title Chapter 7: Runtime and Package Architecture
nav_order 7
parent Superset Terminal Tutorial

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

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
Loading