@trama-dev/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 trama contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @trama-dev/cli
+
+The CLI for [trama](https://github.com/NaNhkNaN/trama) — where the program is the orchestration.
+
+```bash
+npm install -g @trama-dev/cli
+```
+
+Five commands. That's the whole interface.
+
+```bash
+trama create optimizer "improve sort.ts by benchmarking alternatives"
+trama run optimizer
+trama update optimizer "also track memory usage"
+trama list
+trama logs optimizer
+```
+
+`create` turns your intent into a TypeScript program. `run` executes it deterministically. `update` rewrites it with new requirements. The program is the only artifact — no configs, no graphs, no prompts to manage.
+
+See the [main README](https://github.com/NaNhkNaN/trama) for the full picture.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { join } from "path";
+import { homedir } from "os";
+import { createProject, runProgram, updateProject, listProjects, showLogs, validateProjectName, } from "@trama-dev/runtime/runner";
+const cli = new Command()
+    .name("trama")
+    .description("A minimal runtime for agent-authored programs")
+    .version("0.1.0");
+cli
+    .command("create <name> <prompt>")
+    .description("Generate a new program from a natural language prompt")
+    .option("--model <model>", "LLM model to use")
+    .action(async (name, prompt, opts) => {
+    try {
+        await createProject(name, prompt, opts.model ? { model: opts.model } : undefined);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
+cli
+    .command("run <name>")
+    .description("Execute a program")
+    .option("--timeout <ms>", "Execution timeout in ms", "300000")
+    .action(async (name, opts) => {
+    try {
+        validateProjectName(name);
+        const timeout = Number(opts.timeout);
+        if (!Number.isInteger(timeout) || timeout <= 0) {
+            console.error(`Error: --timeout must be a positive integer (got "${opts.timeout}")`);
+            process.exit(1);
+        }
+        const projectDir = join(homedir(), ".trama", "projects", name);
+        await runProgram({ projectDir, timeout });
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
+cli
+    .command("update <name> <prompt>")
+    .description("Update an existing program with new requirements")
+    .action(async (name, prompt) => {
+    try {
+        await updateProject(name, prompt);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
+cli
+    .command("list")
+    .description("List all projects")
+    .action(async () => {
+    try {
+        await listProjects();
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
+cli
+    .command("logs <name>")
+    .description("Show logs from last run")
+    .action(async (name) => {
+    try {
+        await showLogs(name);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+});
+cli.parse();

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@trama-dev/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "trama": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "CLI for trama — an agentic runtime for agent-authored TypeScript programs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NaNhkNaN/trama.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/NaNhkNaN/trama",
+  "bugs": "https://github.com/NaNhkNaN/trama/issues",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@trama-dev/runtime": "0.1.0",
+    "commander": "^12.0.0"
+  }
+}