@adrive/cli 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,84 @@
+# @adrive/cli
+
+The `adrive` binary — a thin CLI for [AgentDrive](https://agentdrive.sh), the persistent workspace your agents share across Claude Code, Codex, Cursor, and LangGraph.
+
+## Install
+
+```sh
+npm i -g @adrive/cli
+adrive init
+```
+
+Or use the one-line installer:
+
+```sh
+curl -fsSL agentdrive.sh/install | sh
+```
+
+`adrive init` opens a browser to log you in (no localhost server, polling-style), then auto-detects installed agent tools (Claude Code, Cursor, Codex CLI, Cline, Continue, Zed) and wires the AgentDrive MCP server into each.
+
+## Configuration
+
+Stored at `$XDG_CONFIG_HOME/agentdrive/config.json`, falling back to `~/.config/agentdrive/config.json`. The file is chmod 600. Schema:
+
+```json
+{
+  "api_url": "https://app.agentdrive.sh",
+  "api_key": "agentdrive_live_...",
+  "agent_id": "ag_...",
+  "org_id": "org_...",
+  "agent_platform": "cli",
+  "default_workspace": "ws_..."
+}
+```
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `adrive init` | First-run wizard: log in + wire MCP into every installed agent tool |
+| `adrive auth login` | Open browser, log in, store API key |
+| `adrive auth logout` | Wipe local credentials |
+| `adrive auth status` | Show whether you're logged in + masked key |
+| `adrive whoami` | Print principal info from the API |
+| `adrive ls` | List workspaces |
+| `adrive push <file> [--workspace ws] [--remote-path p]` | Upload a local file |
+| `adrive pull <ws-id>/<path> [-o out]` | Download a file (stdout by default) |
+| `adrive search <query> [--top-k N] [--platform claude-code] [--workspace ws]` | Semantic search across artifacts |
+| `adrive context <task> [--limit N] [--workspace ws]` | Auto-pull artifacts relevant to a task |
+| `adrive run-log <task> [--status success|failure|partial] [--ref f] [--produced f]` | Log an agent run |
+| `adrive billing` | Open the Stripe billing portal in your browser |
+| `adrive plan` | Show current plan, usage, and quotas |
+
+`-v` / `--version` and `--help` work at every level.
+
+## Authentication
+
+`adrive` uses Cursor-style polling auth — no localhost server:
+
+1. `adrive auth login` calls `POST /v1/auth/cli/start` to get a short-lived auth URL.
+2. The CLI opens the URL in your default browser. You complete the login in the dashboard (Google, GitHub, or email magic link).
+3. The CLI polls `GET /v1/auth/cli/poll?id=<id>` every 1.5s for up to 10 minutes.
+4. On success, the returned `api_key` is stored at chmod 600.
+
+If the browser does not auto-launch (e.g. headless server, SSH session), the URL is printed prominently so you can open it manually.
+
+## Auto-detect + wire
+
+`adrive init` looks for these config files and merges the AgentDrive MCP server entry in (preserving any servers you already have):
+
+| Tool | Config path |
+|---|---|
+| Claude Code | `~/.claude/mcp-servers.json` |
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%/Claude/claude_desktop_config.json` (Windows), `~/.config/Claude/claude_desktop_config.json` (Linux) |
+| Codex CLI | `~/.codex/config.toml` |
+| Cursor | `~/.cursor/mcp.json` |
+| Cline | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` (or the Linux equivalent) |
+| Continue | `~/.continue/config.json` |
+| Zed | `~/.config/zed/settings.json` |
+
+Existing entries are merged, not overwritten. An existing `agentdrive` entry is replaced in place.
+
+## License
+
+Apache-2.0. See the repo's [LICENSING.md](https://github.com/Rakesh1002/agentdrive/blob/main/LICENSING.md) for the full package-by-package breakdown.

package/dist/commands/auth-login.js

@@ -0,0 +1,23 @@
+import kleur from 'kleur';
+import { CliApiClient } from '../lib/api-client.js';
+import { DEFAULT_API_URL, readConfig, writeConfig } from '../lib/config.js';
+import { pollAuth } from '../lib/poll-auth.js';
+export async function cmdAuthLogin(opts = {}) {
+    const existing = await readConfig();
+    const apiUrl = opts.apiUrl ?? existing?.api_url ?? DEFAULT_API_URL;
+    const client = new CliApiClient({ baseUrl: apiUrl, agentPlatform: 'cli' });
+    const result = await pollAuth(client);
+    await writeConfig({
+        api_url: apiUrl,
+        api_key: result.api_key,
+        agent_id: result.agent_id,
+        org_id: result.org_id,
+        agent_platform: 'cli',
+        default_workspace: existing?.default_workspace,
+    });
+    process.stdout.write(`${kleur.green('[ok]')} API key saved.\n`);
+    if (result.agent_id)
+        process.stdout.write(`     agent_id: ${result.agent_id}\n`);
+    if (result.org_id)
+        process.stdout.write(`     org_id:   ${result.org_id}\n`);
+}

package/dist/commands/auth-logout.js

@@ -0,0 +1,24 @@
+import prompts from 'prompts';
+import kleur from 'kleur';
+import { configPath, deleteConfig } from '../lib/config.js';
+export async function cmdAuthLogout(opts = {}) {
+    if (!opts.yes) {
+        const res = await prompts({
+            type: 'confirm',
+            name: 'ok',
+            message: 'Wipe local AgentDrive credentials?',
+            initial: false,
+        });
+        if (!res.ok) {
+            process.stdout.write('Cancelled.\n');
+            return;
+        }
+    }
+    const removed = await deleteConfig();
+    if (removed) {
+        process.stdout.write(`${kleur.green('[ok]')} Logged out. Removed ${configPath()}.\n`);
+    }
+    else {
+        process.stdout.write('Nothing to remove — already logged out.\n');
+    }
+}

package/dist/commands/auth-status.js

@@ -0,0 +1,20 @@
+import kleur from 'kleur';
+import { readConfig } from '../lib/config.js';
+export async function cmdAuthStatus() {
+    const c = await readConfig();
+    if (!c || !c.api_key) {
+        process.stdout.write(`${kleur.yellow('[not logged in]')} Run \`adrive auth login\` or \`adrive init\`.\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const masked = `${c.api_key.slice(0, 12)}${'.'.repeat(8)}`;
+    process.stdout.write(`${kleur.green('[ok]')} Logged in.\n`);
+    process.stdout.write(`  api_url:    ${c.api_url}\n`);
+    process.stdout.write(`  api_key:    ${masked}\n`);
+    if (c.org_id)
+        process.stdout.write(`  org_id:     ${c.org_id}\n`);
+    if (c.agent_id)
+        process.stdout.write(`  agent_id:   ${c.agent_id}\n`);
+    if (c.default_workspace)
+        process.stdout.write(`  workspace:  ${c.default_workspace}\n`);
+}

package/dist/commands/billing.js

@@ -0,0 +1,32 @@
+import open from 'open';
+import kleur from 'kleur';
+import { ApiError, CliApiClient } from '../lib/api-client.js';
+import { requireLogin } from '../lib/config.js';
+export async function cmdBilling() {
+    const cfg = await requireLogin();
+    const client = new CliApiClient({
+        baseUrl: cfg.api_url,
+        apiKey: cfg.api_key,
+        agentPlatform: cfg.agent_platform ?? 'cli',
+        agentRole: cfg.agent_role,
+    });
+    try {
+        const portal = await client.billingPortal();
+        try {
+            await open(portal.url);
+        }
+        catch {
+            // Browser launch can fail in headless contexts; the URL is printed below.
+        }
+        process.stdout.write(`${kleur.green('[ok]')} Opened billing portal in browser.\n`);
+        process.stdout.write(`  ${portal.url}\n`);
+    }
+    catch (err) {
+        if (err instanceof ApiError && err.status === 404) {
+            process.stdout.write(`${kleur.yellow('[info]')} Billing portal not yet enabled — coming in v1.\n`);
+            process.exitCode = 1;
+            return;
+        }
+        throw err;
+    }
+}

package/dist/commands/context.js

@@ -0,0 +1,33 @@
+import kleur from 'kleur';
+import { CliApiClient } from '../lib/api-client.js';
+import { requireLogin } from '../lib/config.js';
+function truncate(s, n) {
+    if (!s)
+        return '';
+    return s.length <= n ? s : `${s.slice(0, n - 1)}…`;
+}
+export async function cmdContext(task, opts = {}) {
+    const cfg = await requireLogin();
+    const client = new CliApiClient({
+        baseUrl: cfg.api_url,
+        apiKey: cfg.api_key,
+        agentPlatform: cfg.agent_platform ?? 'cli',
+        agentRole: cfg.agent_role,
+    });
+    const limit = opts.limit ? Number.parseInt(opts.limit, 10) : undefined;
+    const res = await client.context({
+        task,
+        workspace_id: opts.workspace ?? cfg.default_workspace,
+        limit,
+    });
+    if (!res.artifacts.length) {
+        process.stdout.write('No relevant artifacts.\n');
+        return;
+    }
+    for (const a of res.artifacts) {
+        const score = a.score.toFixed(2);
+        process.stdout.write(`${kleur.cyan(a.path)} · score=${score} · by=${a.agent_id}@${a.agent_platform}\n`);
+        if (a.snippet)
+            process.stdout.write(`  ${kleur.dim(truncate(a.snippet, 500))}\n`);
+    }
+}

package/dist/commands/init.js

@@ -0,0 +1,84 @@
+import prompts from 'prompts';
+import kleur from 'kleur';
+import { CliApiClient } from '../lib/api-client.js';
+import { DEFAULT_API_URL, readConfig, writeConfig } from '../lib/config.js';
+import { pollAuth } from '../lib/poll-auth.js';
+import { detectInstalledAgents, wireAgent } from '../lib/detect-agents.js';
+export async function cmdInit(opts = {}) {
+    const existing = await readConfig();
+    const apiUrl = opts.apiUrl ?? existing?.api_url ?? DEFAULT_API_URL;
+    let apiKey = existing?.api_key;
+    let agentId = existing?.agent_id;
+    let orgId = existing?.org_id;
+    if (apiKey) {
+        process.stdout.write(`Already logged in (api key ${apiKey.slice(0, 12)}...).\n`);
+        if (!opts.yes) {
+            const res = await prompts({
+                type: 'confirm',
+                name: 'relogin',
+                message: 'Log in again?',
+                initial: false,
+            });
+            if (res.relogin) {
+                apiKey = undefined;
+            }
+        }
+    }
+    if (!apiKey) {
+        process.stdout.write(`${kleur.bold('Step 1.')} Log in.\n`);
+        const client = new CliApiClient({ baseUrl: apiUrl, agentPlatform: 'cli' });
+        const auth = await pollAuth(client);
+        apiKey = auth.api_key;
+        agentId = auth.agent_id;
+        orgId = auth.org_id;
+        await writeConfig({
+            api_url: apiUrl,
+            api_key: apiKey,
+            agent_id: agentId,
+            org_id: orgId,
+            agent_platform: 'cli',
+            default_workspace: existing?.default_workspace,
+        });
+    }
+    process.stdout.write(`\n${kleur.bold('Step 2.')} Detect installed agent tools.\n`);
+    const installed = await detectInstalledAgents();
+    if (installed.length === 0) {
+        process.stdout.write('  No agent configs found. Skipping MCP wiring.\n');
+    }
+    else {
+        process.stdout.write(`  Found: ${installed.map((t) => t.name).join(', ')}\n`);
+    }
+    const wired = [];
+    const skipped = [];
+    for (const t of installed) {
+        let go = opts.yes ?? false;
+        if (!go) {
+            const res = await prompts({
+                type: 'confirm',
+                name: 'wire',
+                message: `Wire AgentDrive MCP into ${t.name} (${t.configPath})?`,
+                initial: true,
+            });
+            go = !!res.wire;
+        }
+        if (!go) {
+            skipped.push(t.name);
+            continue;
+        }
+        try {
+            await wireAgent(t, { apiKey: apiKey, apiUrl, agentPlatform: t.defaultPlatform });
+            wired.push(t.name);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            skipped.push(`${t.name} (${msg})`);
+        }
+    }
+    process.stdout.write(`\n${kleur.bold('Summary')}\n`);
+    process.stdout.write(`  Wired:   ${wired.length ? wired.join(', ') : '(none)'}\n`);
+    process.stdout.write(`  Skipped: ${skipped.length ? skipped.join(', ') : '(none)'}\n`);
+    process.stdout.write('\nNext steps:\n');
+    process.stdout.write('  - Try: `adrive ls` to list workspaces\n');
+    process.stdout.write('  - Try: `adrive push README.md` to share a file\n');
+    process.stdout.write('  - Or ask Claude Code: "share this file via AgentDrive"\n');
+}

package/dist/commands/ls.js

@@ -0,0 +1,23 @@
+import { CliApiClient } from '../lib/api-client.js';
+import { requireLogin } from '../lib/config.js';
+export async function cmdLs() {
+    const cfg = await requireLogin();
+    const client = new CliApiClient({
+        baseUrl: cfg.api_url,
+        apiKey: cfg.api_key,
+        agentPlatform: cfg.agent_platform ?? 'cli',
+        agentRole: cfg.agent_role,
+    });
+    const workspaces = await client.listWorkspaces();
+    if (workspaces.length === 0) {
+        process.stdout.write('No workspaces. Create one via the dashboard or `POST /v1/workspaces`.\n');
+        return;
+    }
+    const idWidth = Math.max(...workspaces.map((w) => w.id.length));
+    const nameWidth = Math.max(...workspaces.map((w) => w.name.length));
+    for (const w of workspaces) {
+        const id = w.id.padEnd(idWidth);
+        const name = w.name.padEnd(nameWidth);
+        process.stdout.write(`${id}  ${name}  ${w.created_at}\n`);
+    }
+}

package/dist/commands/plan.js

@@ -0,0 +1,36 @@
+import kleur from 'kleur';
+import { CliApiClient } from '../lib/api-client.js';
+import { requireLogin } from '../lib/config.js';
+function fmt(n) {
+    return Number.isFinite(n) ? n.toLocaleString() : '-';
+}
+export async function cmdPlan() {
+    const cfg = await requireLogin();
+    const client = new CliApiClient({
+        baseUrl: cfg.api_url,
+        apiKey: cfg.api_key,
+        agentPlatform: cfg.agent_platform ?? 'cli',
+        agentRole: cfg.agent_role,
+    });
+    const plan = await client.billingPlan();
+    process.stdout.write(`${kleur.bold('Plan')}: ${plan.plan}\n`);
+    if (plan.trial_ends_at) {
+        process.stdout.write(`Trial ends: ${plan.trial_ends_at}\n`);
+    }
+    const keys = new Set([...Object.keys(plan.usage ?? {}), ...Object.keys(plan.quota ?? {})]);
+    if (keys.size === 0)
+        return;
+    const rows = [...keys].map((k) => ({
+        metric: k,
+        usage: fmt(plan.usage?.[k] ?? 0),
+        quota: fmt(plan.quota?.[k] ?? 0),
+    }));
+    const w1 = Math.max('metric'.length, ...rows.map((r) => r.metric.length));
+    const w2 = Math.max('usage'.length, ...rows.map((r) => r.usage.length));
+    const w3 = Math.max('quota'.length, ...rows.map((r) => r.quota.length));
+    process.stdout.write(`\n${'metric'.padEnd(w1)}  ${'usage'.padEnd(w2)}  ${'quota'.padEnd(w3)}\n`);
+    process.stdout.write(`${'-'.repeat(w1)}  ${'-'.repeat(w2)}  ${'-'.repeat(w3)}\n`);
+    for (const r of rows) {
+        process.stdout.write(`${r.metric.padEnd(w1)}  ${r.usage.padEnd(w2)}  ${r.quota.padEnd(w3)}\n`);
+    }
+}

package/dist/commands/pull.js

@@ -0,0 +1,29 @@
+import { promises as fs } from 'node:fs';
+import kleur from 'kleur';
+import { CliApiClient } from '../lib/api-client.js';
+import { requireLogin } from '../lib/config.js';
+export async function cmdPull(spec, opts = {}) {
+    const cfg = await requireLogin();
+    const client = new CliApiClient({
+        baseUrl: cfg.api_url,
+        apiKey: cfg.api_key,
+        agentPlatform: cfg.agent_platform ?? 'cli',
+        agentRole: cfg.agent_role,
+    });
+    const slash = spec.indexOf('/');
+    if (slash <= 0) {
+        throw new Error('Expected <workspace-id>/<path>');
+    }
+    const workspaceId = spec.slice(0, slash);
+    const remotePath = spec.slice(slash + 1);
+    const file = await client.readFileByPath(workspaceId, remotePath);
+    if (opts.out) {
+        await fs.writeFile(opts.out, file.content, 'utf8');
+        process.stdout.write(`${kleur.green('[ok]')} wrote ${opts.out} (v${file.version})\n`);
+    }
+    else {
+        process.stdout.write(file.content);
+        if (!file.content.endsWith('\n'))
+            process.stdout.write('\n');
+    }
+}

package/dist/commands/push.js

@@ -0,0 +1,31 @@
+import { promises as fs } from 'node:fs';
+import { basename } from 'node:path';
+import kleur from 'kleur';
+import { CliApiClient } from '../lib/api-client.js';
+import { requireLogin } from '../lib/config.js';
+export async function cmdPush(localPath, opts = {}) {
+    const cfg = await requireLogin();
+    const client = new CliApiClient({
+        baseUrl: cfg.api_url,
+        apiKey: cfg.api_key,
+        agentPlatform: cfg.agent_platform ?? 'cli',
+        agentRole: cfg.agent_role,
+    });
+    const content = await fs.readFile(localPath, 'utf8');
+    const remotePath = opts.remotePath ?? basename(localPath);
+    let workspaceId = opts.workspace ?? cfg.default_workspace;
+    if (!workspaceId) {
+        const list = await client.listWorkspaces();
+        if (list.length === 1) {
+            workspaceId = list[0].id;
+        }
+        else if (list.length === 0) {
+            throw new Error('No workspaces. Create one first.');
+        }
+        else {
+            throw new Error(`Multiple workspaces — specify --workspace <id>. Available: ${list.map((w) => w.id).join(', ')}`);
+        }
+    }
+    const result = await client.writeFile(workspaceId, remotePath, content, opts.message);
+    process.stdout.write(`${kleur.green('[ok]')} pushed ${localPath} -> ${workspaceId}:${result.path} (v${result.version})\n`);
+}

package/dist/commands/run-log.js

@@ -0,0 +1,21 @@
+import kleur from 'kleur';
+import { CliApiClient } from '../lib/api-client.js';
+import { requireLogin } from '../lib/config.js';
+export async function cmdRunLog(task, opts = {}) {
+    const cfg = await requireLogin();
+    const client = new CliApiClient({
+        baseUrl: cfg.api_url,
+        apiKey: cfg.api_key,
+        agentPlatform: cfg.agent_platform ?? 'cli',
+        agentRole: cfg.agent_role,
+    });
+    const duration = opts.duration ? Number.parseInt(opts.duration, 10) : undefined;
+    const res = await client.logRun({
+        task,
+        status: opts.status ?? 'success',
+        artifacts_referenced: opts.ref,
+        artifacts_produced: opts.produced,
+        duration_ms: duration,
+    });
+    process.stdout.write(`${kleur.green('[ok]')} run logged: ${res.run_id}\n`);
+}