agentful 0.1.0 → 0.1.1

package/README.md

@@ -1,28 +1,44 @@
 # Agentful CLI
 
-Agentful in your terminal: develop locally, then `agentful push` for a live
-preview URL on your Agentful workspace.
+Develop locally, ship with one command. `agentful` gives you an AI coding
+interface in your terminal and moves the project into your Agentful workspace
+with a live preview URL — using the same models and credits as the web app.
 
+```bash
+npm i -g agentful
 ```
-$ agentful login          # device flow — confirm the code in your browser
-$ agentful init           # create or link the cloud project (.agentful/project.json)
-$ agentful push           # upload source → cloud build → preview URL
-  ✔ Live preview: https://preview-<project>.agentful.dev/
-$ agentful push --prebuilt  # upload a locally built dist/ instead
-$ agentful open           # open the preview in the browser
+
+## Quickstart
+
+```bash
+agentful login              # once: confirm the code in your browser
+agentful init               # create or link the cloud project
+agentful                    # start the coding interface
+agentful push               # upload, cloud build, preview URL
+agentful open               # open the preview
 ```
 
-## Commands (M1)
+## Commands
 
 | Command | Purpose |
-|---|---|
-| `login` / `logout` / `whoami` | Device-flow auth against the Agentful account (14-day token in `~/.config/agentful/auth.json`, chmod 600) |
-| `init [--link <projectId>] [--title <t>]` | Create a cloud project (or link an existing one) and write `.agentful/project.json` |
-| `push [--prebuilt [--dir <path>]]` | Zip-push the tree (respects `.gitignore`; always excludes `.git`, `node_modules`, build outputs, `.env*`), cloud build, deploy, print preview URL |
-| `open` | Open the preview URL |
-
-Planned next: `agentful tui` (bundled OpenCode with your Agentful models/credits),
-`publish <subdomain>`, `pull`. See `planned/agentful-cli-tui-concept.md`.
+| --- | --- |
+| `login` / `logout` / `whoami` | Browser-based sign-in; the token is kept in the macOS Keychain |
+| `init [--link <id>] [--title <t>]` | Create a cloud project or link an existing one (`.agentful/project.json`) |
+| `push [--prebuilt [--dir <path>]]` | Upload the source and build in the cloud; `--prebuilt` uploads a local build |
+| `open` | Open the live preview |
+| `share [--private]` | Make the preview public, or private again |
+| `publish <subdomain>` | Publish at `https://<subdomain>.agentful.dev` |
+| `pull [--force]` | Fetch the cloud state into this directory |
+| `models [--add-local]` | Show available models, manage your own providers |
+| `upgrade` | Update the CLI to the latest published version |
+| `licenses` | Licences of the software shipped with this CLI |
+| `-s, --session <id>` | Resume a previous coding session |
+
+Inside the interface, `/` lists the Agentful commands (`/setup`, `/push`,
+`/preview`, `/publish`, `/share`, `/status`) alongside the built-in ones.
+
+`push` respects your `.gitignore` and always excludes `.git`, `node_modules`,
+build output and every `.env` file. Uploads are capped at 6 MB.
 
 ## Platform support
 
@@ -67,6 +83,16 @@ Local providers are governed by the organization's BYOK policy (`/api/org/me`):
 the CLI, so it is a cooperative control, not a cryptographic one — the config
 lives on the user's machine.
 
+## Known limitation: the engine's exit banner
+
+When the TUI closes, the engine writes its own splash (its logo plus a
+`opencode -s <id>` hint) straight into the scrollback. v1.18.x offers no flag,
+env var or config to suppress it, and patching the binary would break its
+macOS signature. We therefore let it stand and print our own last line with
+the command that actually works here — `agentful -s <id>`; the engine's hint
+cannot work, because that binary is not on the user's PATH and its data lives
+in a different directory.
+
 ## Branding
 
 Everything user-visible lives in `src/branding/`: `branding.ts` (palette,

package/dist/index.cjs

@@ -3432,7 +3432,7 @@ var {
 } = import_index.default;
 
 // src/branding.ts
-var VERSION = "0.1.0" ? "0.1.0" : null.version;
+var VERSION = "0.1.1" ? "0.1.1" : null.version;
 var brand = {
   name: "agentful",
   // the command users type
@@ -3792,7 +3792,11 @@ function writeProjectConfig(config, cwd = process.cwd()) {
 function requireProject(cwd = process.cwd()) {
   const config = readProjectConfig(cwd);
   if (!config) {
-    throw new ApiError(0, "not_initialized", "No Agentful project here. Run `agentful init` first.");
+    throw new ApiError(
+      0,
+      "not_initialized",
+      "No Agentful project here. Run `agentful init` to create or link one (inside the TUI: /setup)."
+    );
   }
   return config;
 }
@@ -4763,8 +4767,8 @@ async function openCommand() {
 }
 
 // src/commands/tui.ts
-var import_node_child_process4 = require("child_process");
-var import_node_path11 = require("path");
+var import_node_child_process5 = require("child_process");
+var import_node_path12 = require("path");
 
 // src/lib/binWrapper.ts
 var import_node_fs4 = require("fs");
@@ -5088,32 +5092,38 @@ export default plugin
 }
 
 // src/branding/commands.ts
+var IF_NOT_LINKED = 'If the command reports "No Agentful project here", this directory is not linked yet: ask me for a project title, run `agentful init --title "<title>"`, then run the original command again and report its result.';
 var SLASH_COMMANDS = {
+  setup: {
+    description: `${brand.displayName}: create or link the cloud project for this directory`,
+    template: 'Check whether .agentful/project.json exists. If it does, report the linked project title and id and stop. Otherwise ask me for a project title, then run `agentful init --title "<title>"` using the bash tool and report what it created. Do not modify any other project files.'
+  },
   push: {
-    description: `Deploy this project to ${brand.displayName} and get a preview URL`,
-    template: "Run `agentful push` from the project root using the bash tool. Stream what it prints, and when it finishes report the preview URL on its own line. If it fails, show the error and suggest the fix \u2014 do not modify project files unless I ask."
+    description: `${brand.displayName}: deploy this project and get a preview URL`,
+    template: "Run `agentful push` from the project root using the bash tool. Stream what it prints, and when it finishes report the preview URL on its own line. " + IF_NOT_LINKED + " If it fails for another reason, show the error and suggest the fix \u2014 do not modify project files unless I ask."
   },
   preview: {
-    description: "Open the live preview URL in the browser",
-    template: "Run `agentful open` from the project root using the bash tool and report the URL it opened."
+    description: `${brand.displayName}: open the live preview in the browser`,
+    template: "Run `agentful open` from the project root using the bash tool and report the URL it opened. Note that `open` neither builds nor uploads \u2014 if I have not pushed yet, say so and offer to run `agentful push` first. " + IF_NOT_LINKED
   },
   publish: {
-    description: "Publish the built project on a public subdomain",
-    template: "Ask me for the subdomain if I did not provide one in $ARGUMENTS, then run `agentful publish <subdomain>` from the project root using the bash tool and report the public URL."
+    description: `${brand.displayName}: publish on a public subdomain`,
+    template: "Ask me for the subdomain if I did not provide one in $ARGUMENTS, then run `agentful publish <subdomain>` from the project root using the bash tool and report the public URL. " + IF_NOT_LINKED
   },
   share: {
-    description: "Make the live preview public (or private again)",
-    template: "Run `agentful share` from the project root using the bash tool (add `--private` if $ARGUMENTS says private) and report the resulting visibility and URL."
+    description: `${brand.displayName}: make the live preview public (or private again)`,
+    template: "Run `agentful share` from the project root using the bash tool (add `--private` if $ARGUMENTS says private) and report the resulting visibility and URL. " + IF_NOT_LINKED
   },
   status: {
-    description: "Show cloud build and deployment status",
-    template: "Run `agentful whoami` and then check the project status by running `agentful push --help` is NOT needed \u2014 instead read .agentful/project.json and report the linked project id and title, then summarize the latest build state from the last `agentful push` output if it is in this session."
+    description: `${brand.displayName}: show the linked project and account`,
+    template: "Run `agentful whoami` using the bash tool. Then read .agentful/project.json and report the linked project title and id, plus the preview URL https://preview-<projectId>.agentful.dev/. If the file does not exist, say that this directory is not linked yet and that `/setup` creates the link."
   }
 };
 function commandMarkdown(name) {
   const cmd = SLASH_COMMANDS[name];
+  const description = JSON.stringify(cmd.description);
   return `---
-description: ${cmd.description}
+description: ${description}
 agent: build
 ---
 
@@ -5390,8 +5400,33 @@ function writeLocalProvidersExample() {
   return path;
 }
 
+// src/lib/sessions.ts
+var import_node_fs10 = require("fs");
+var import_node_path11 = require("path");
+var import_node_child_process4 = require("child_process");
+var SEP = "";
+function sqlite(dbPath, sql) {
+  const res = (0, import_node_child_process4.spawnSync)("sqlite3", ["-readonly", dbPath, sql], { encoding: "utf8" });
+  if (res.status !== 0 || !res.stdout) return null;
+  return res.stdout.trim().split("\n").filter(Boolean);
+}
+function lastSessionForDirectory(cwd = process.cwd()) {
+  const dbPath = (0, import_node_path11.join)(engineXdg().dataHome, "opencode", "opencode.db");
+  if (!(0, import_node_fs10.existsSync)(dbPath)) return null;
+  const escaped = cwd.replace(/'/g, "''");
+  const rows = sqlite(
+    dbPath,
+    `SELECT id || char(31) || COALESCE(title, slug, '') FROM session
+     WHERE directory = '${escaped}' AND time_archived IS NULL
+     ORDER BY COALESCE(time_updated, time_created) DESC LIMIT 1;`
+  );
+  if (!rows?.length) return null;
+  const [id, title] = rows[0].split(SEP);
+  return id ? { id, title: title || "" } : null;
+}
+
 // src/commands/tui.ts
-async function tuiCommand() {
+async function tuiCommand(opts = {}) {
   console.log(banner());
   const auth = await ensureAuth();
   const project = readProjectConfig();
@@ -5434,14 +5469,15 @@ async function tuiCommand() {
   console.log("");
   if (process.stdout.isTTY) process.stdout.write(`\x1B]0;${brand.displayName}\x07`);
   const code = await new Promise((resolve) => {
-    const child = (0, import_node_child_process4.spawn)(binPath, [], {
+    const engineArgs = opts.session ? ["--session", opts.session] : [];
+    const child = (0, import_node_child_process5.spawn)(binPath, engineArgs, {
       stdio: "inherit",
       cwd: process.cwd(),
       env: {
         ...process.env,
         // Slash commands run `agentful …` through the agent's bash tool, which
         // has no access to the user's shell aliases.
-        PATH: `${binDir}${import_node_path11.delimiter}${process.env.PATH || ""}`,
+        PATH: `${binDir}${import_node_path12.delimiter}${process.env.PATH || ""}`,
         XDG_CONFIG_HOME: xdg.configHome,
         XDG_DATA_HOME: xdg.dataHome,
         XDG_STATE_HOME: xdg.stateHome,
@@ -5476,6 +5512,14 @@ async function tuiCommand() {
     }
   } catch {
   }
+  try {
+    const last = lastSessionForDirectory();
+    if (last) {
+      const label = last.title ? ` ${paint.dim(`(${last.title})`)}` : "";
+      ui.info(`Resume: ${paint.accent(`agentful -s ${last.id}`)}${label}`);
+    }
+  } catch {
+  }
   process.exitCode = code;
 }
 
@@ -5536,26 +5580,26 @@ async function shareCommand(opts) {
 }
 
 // src/commands/pull.ts
-var import_node_fs10 = require("fs");
-var import_node_path12 = require("path");
+var import_node_fs11 = require("fs");
+var import_node_path13 = require("path");
 function isProbablyBase64Binary(path) {
   return /\.(png|jpe?g|gif|webp|ico|woff2?|ttf|otf|eot|pdf|zip|mp[34]|webm|avif)$/i.test(path);
 }
 function writeEntry(root, rel, value) {
-  const target = (0, import_node_path12.join)(root, rel);
-  (0, import_node_fs10.mkdirSync)((0, import_node_path12.dirname)(target), { recursive: true });
+  const target = (0, import_node_path13.join)(root, rel);
+  (0, import_node_fs11.mkdirSync)((0, import_node_path13.dirname)(target), { recursive: true });
   const content = typeof value === "object" && value !== null && "content" in value ? String(value.content) : String(value ?? "");
   if (isProbablyBase64Binary(rel)) {
-    (0, import_node_fs10.writeFileSync)(target, Buffer.from(content, "base64"));
+    (0, import_node_fs11.writeFileSync)(target, Buffer.from(content, "base64"));
   } else {
-    (0, import_node_fs10.writeFileSync)(target, content, "utf8");
+    (0, import_node_fs11.writeFileSync)(target, content, "utf8");
   }
 }
 async function pullCommand(opts) {
   console.log(banner());
   const auth = await ensureAuth();
   const project = requireProject();
-  const nonHidden = (0, import_node_fs10.readdirSync)(process.cwd()).filter((n) => n !== ".agentful" && !n.startsWith("."));
+  const nonHidden = (0, import_node_fs11.readdirSync)(process.cwd()).filter((n) => n !== ".agentful" && !n.startsWith("."));
   if (nonHidden.length > 0 && !opts.force) {
     throw new ApiError(
       0,
@@ -5579,9 +5623,9 @@ async function pullCommand(opts) {
         ui.warn(`Skipped ${rel} (HTTP ${resp.status})`);
         continue;
       }
-      const target = (0, import_node_path12.join)(process.cwd(), rel);
-      (0, import_node_fs10.mkdirSync)((0, import_node_path12.dirname)(target), { recursive: true });
-      (0, import_node_fs10.writeFileSync)(target, Buffer.from(await resp.arrayBuffer()));
+      const target = (0, import_node_path13.join)(process.cwd(), rel);
+      (0, import_node_fs11.mkdirSync)((0, import_node_path13.dirname)(target), { recursive: true });
+      (0, import_node_fs11.writeFileSync)(target, Buffer.from(await resp.arrayBuffer()));
       written++;
     }
   } else if (data.files) {
@@ -5663,6 +5707,36 @@ async function modelsCommand(opts) {
   }
 }
 
+// src/commands/upgrade.ts
+var import_node_child_process6 = require("child_process");
+async function upgradeCommand() {
+  console.log(banner());
+  let latest = "";
+  try {
+    const manifest = await request(
+      `${APP_URL}/cli/engine-manifest.json`,
+      { timeoutMs: 8e3 }
+    );
+    latest = manifest.latest_cli_version || "";
+  } catch {
+  }
+  if (latest && compareVersions(VERSION, latest) >= 0) {
+    ui.ok(`Already on the latest version (v${VERSION}).`);
+    return;
+  }
+  if (latest) ui.step(`Updating ${brand.name} v${VERSION} \u2192 v${latest}\u2026`);
+  else ui.step(`Updating ${brand.name} to the latest version\u2026`);
+  const res = (0, import_node_child_process6.spawnSync)("npm", ["install", "-g", `${brand.name}@latest`], { stdio: "inherit" });
+  if (res.status === 0) {
+    ui.ok("Done. Run `agentful --version` to confirm.");
+    return;
+  }
+  ui.fail("The automatic update did not succeed.");
+  ui.info(`Run it yourself: ${paint.accent(`npm install -g ${brand.name}@latest`)}`);
+  ui.info("If that reports a permission error, your Node installation needs sudo or a prefix change.");
+  process.exitCode = 1;
+}
+
 // src/index.ts
 var program2 = new Command();
 var run = (fn) => async (...args) => {
@@ -5684,10 +5758,11 @@ program2.command("whoami").description("Show the signed-in account").action(run(
 program2.command("init").description("Create (or link) the Agentful cloud project for this directory").option("--link <projectId>", "link an existing project instead of creating one").option("--title <title>", "project title (skips the prompt)").action(run((opts) => initCommand(opts)));
 program2.command("push").description("Upload this project and get a live preview URL").option("--prebuilt", "upload a locally built output instead of building in the cloud").option("--dir <path>", "built-output directory for --prebuilt (default: auto-detect)").action(run((opts) => pushCommand(opts)));
 program2.command("open").description("Open the live preview in the browser").action(run(openCommand));
-program2.command("tui", { isDefault: true }).description("Start the Agentful coding TUI (OpenCode with your Agentful account)").action(run(tuiCommand));
+program2.command("tui", { isDefault: true }).description("Start the Agentful coding TUI with your Agentful account").option("-s, --session <id>", "resume a previous session").action(run((opts) => tuiCommand(opts)));
 program2.command("publish <subdomain>").description("Publish the built project at https://<subdomain>.agentful.dev").action(run(publishCommand));
 program2.command("share").description("Make the live preview public (anyone with the link)").option("--private", "make the preview owner-only again").action(run((opts) => shareCommand(opts)));
 program2.command("pull").description("Download the cloud workspace into this directory").option("--force", "overwrite files in a non-empty directory").action(run((opts) => pullCommand(opts)));
 program2.command("models").description("List available models and manage local providers with your own key").option("--add-local", "create/show the local provider file to edit").action(run((opts) => modelsCommand(opts)));
+program2.command("upgrade").description("Update the CLI to the latest version").action(run(upgradeCommand));
 program2.command("licenses").description("Show licenses of the software distributed with this CLI").action(run(licensesCommand));
 program2.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentful",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Agentful in your terminal \u2014 local development with push-to-cloud previews",
   "license": "Apache-2.0",
   "homepage": "https://agentful.dev",