@tomagranate/corsa 1.1.1 → 1.2.0

package/README.md

@@ -76,6 +76,12 @@ cwd = "./backend"
 corsa
 ```
 
+4. Optional: install the `corsa` AI skill from this repository:
+
+```bash
+npx skills add tomagranate/corsa
+```
+
 ## CLI Reference
 
 ### Commands
@@ -85,6 +91,7 @@ corsa
 | `corsa` | Start the TUI dashboard |
 | `corsa init` | Create a sample config file in the current directory |
 | `corsa mcp` | Start the MCP server for AI agent integration |
+| `corsa ctl <subcommand>` | Control running processes through the MCP API |
 
 ### Options
 
@@ -92,6 +99,19 @@ corsa
 |--------|-------------|
 | `-c, --config <path>` | Path to config file (default: `corsa.config.toml`) |
 | `-h, --help` | Show help message |
+| `-v, --version` | Show version information |
+
+### `ctl` Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `corsa ctl list` | List all processes with status and recent logs (`ps`/`ls` aliases) |
+| `corsa ctl logs <name>` | Get recent logs for a process |
+| `corsa ctl stop <name>` | Stop a running process (`rm` alias) |
+| `corsa ctl restart <name>` | Restart a process |
+| `corsa ctl clear <name>` | Clear process logs |
+| `corsa ctl send-keys <name> --key <value>` | Send keypresses/text to an interactive process |
+| `corsa ctl reload` | Reload config and restart processes |
 
 ### Examples
 
@@ -108,6 +128,22 @@ corsa init
 
 # Start MCP server for AI integration
 corsa mcp
+
+# List processes via CLI control API
+corsa ctl list
+corsa ctl ls
+
+# Read logs with filtering
+corsa ctl logs backend --lines 200 --search ERROR --search-type substring
+
+# Stop a process (alias)
+corsa ctl rm backend
+
+# Send interactive input
+corsa ctl send-keys repl --key "help" --key return
+
+# Machine-readable output for agents/scripts
+corsa ctl list --json
 ```
 
 ## Configuration

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tomagranate/corsa",
-	"version": "1.1.1",
+	"version": "1.2.0",
 	"description": "A Terminal User Interface (TUI) for running multiple local development servers and tools simultaneously",
 	"type": "module",
 	"bin": {
@@ -8,12 +8,15 @@
 	},
 	"files": [
 		"bin",
-		"scripts"
+		"scripts",
+		"schemas"
 	],
 	"scripts": {
 		"dev": "bun run src/index.tsx",
 		"build": "bun build src/index.tsx --compile --minify --outfile dist/corsa",
 		"build:all": "bun run scripts/build-all.ts",
+		"config-schema:generate": "bun run scripts/generate-config-schema.ts",
+		"config-schema:check": "bun run config-schema:generate && git diff --exit-code -- schemas/corsa.schema.json",
 		"postinstall": "node scripts/postinstall.cjs",
 		"check": "biome check --fix",
 		"check:nofix": "biome check",
@@ -51,6 +54,7 @@
 		"@modelcontextprotocol/sdk": "^1.25.3",
 		"@opentui/core": "^0.1.72",
 		"@opentui/react": "^0.1.72",
+		"@xterm/headless": "^6.0.0",
 		"fuzzysort": "^3.1.0",
 		"react": "^19.2.3",
 		"zod": "^4.3.6",

package/schemas/corsa.schema.json

@@ -0,0 +1,180 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"type": "object",
+	"properties": {
+		"tools": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"name": {
+						"type": "string",
+						"minLength": 1
+					},
+					"command": {
+						"type": "string",
+						"minLength": 1
+					},
+					"args": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						}
+					},
+					"cwd": {
+						"type": "string"
+					},
+					"env": {
+						"type": "object",
+						"propertyNames": {
+							"type": "string"
+						},
+						"additionalProperties": {
+							"type": "string"
+						}
+					},
+					"cleanup": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						}
+					},
+					"description": {
+						"type": "string"
+					},
+					"healthCheck": {
+						"type": "object",
+						"properties": {
+							"url": {
+								"type": "string"
+							},
+							"interval": {
+								"type": "integer",
+								"exclusiveMinimum": 0,
+								"maximum": 9007199254740991
+							},
+							"retries": {
+								"type": "integer",
+								"exclusiveMinimum": 0,
+								"maximum": 9007199254740991
+							}
+						},
+						"required": ["url"],
+						"additionalProperties": false
+					},
+					"ui": {
+						"type": "object",
+						"properties": {
+							"label": {
+								"type": "string"
+							},
+							"url": {
+								"type": "string"
+							}
+						},
+						"required": ["label", "url"],
+						"additionalProperties": false
+					},
+					"dependsOn": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						}
+					},
+					"interactive": {
+						"type": "boolean"
+					}
+				},
+				"required": ["name", "command"],
+				"additionalProperties": false
+			}
+		},
+		"home": {
+			"type": "object",
+			"properties": {
+				"enabled": {
+					"type": "boolean"
+				},
+				"title": {
+					"type": "string"
+				},
+				"titleFont": {
+					"type": "string",
+					"enum": ["tiny", "block", "shade", "slick", "huge", "grid", "pallet"]
+				},
+				"titleAlign": {
+					"type": "string",
+					"enum": ["left", "center"]
+				}
+			},
+			"additionalProperties": false
+		},
+		"mcp": {
+			"type": "object",
+			"properties": {
+				"enabled": {
+					"type": "boolean"
+				},
+				"port": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 65535
+				}
+			},
+			"additionalProperties": false
+		},
+		"processes": {
+			"type": "object",
+			"properties": {
+				"cleanupOrphans": {
+					"type": "boolean"
+				}
+			},
+			"additionalProperties": false
+		},
+		"ui": {
+			"type": "object",
+			"properties": {
+				"sidebarPosition": {
+					"type": "string",
+					"enum": ["left", "right"]
+				},
+				"horizontalTabPosition": {
+					"type": "string",
+					"enum": ["top", "bottom"]
+				},
+				"widthThreshold": {
+					"type": "number",
+					"exclusiveMinimum": 0
+				},
+				"theme": {
+					"type": "string"
+				},
+				"maxLogLines": {
+					"type": "integer",
+					"exclusiveMinimum": 0,
+					"maximum": 9007199254740991
+				},
+				"showTabNumbers": {
+					"type": "boolean"
+				},
+				"showLineNumbers": {
+					"anyOf": [
+						{
+							"type": "boolean"
+						},
+						{
+							"type": "string",
+							"const": "auto"
+						}
+					]
+				}
+			},
+			"additionalProperties": false
+		}
+	},
+	"required": ["tools"],
+	"additionalProperties": false,
+	"title": "corsa config",
+	"description": "Configuration schema for corsa.config.toml"
+}

package/scripts/generate-config-schema.ts

@@ -0,0 +1,13 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { $ } from "bun";
+import { createCorsaConfigJsonSchema } from "../src/lib/config/schema";
+
+const schemaPath = join(import.meta.dir, "..", "schemas", "corsa.schema.json");
+const schema = createCorsaConfigJsonSchema();
+
+await mkdir(dirname(schemaPath), { recursive: true });
+await writeFile(schemaPath, `${JSON.stringify(schema, null, 2)}\n`, "utf-8");
+await $`bunx @biomejs/biome format --write ${schemaPath}`;
+
+console.log(`Generated ${schemaPath}`);