@agentskit/cli 0.5.0 → 0.5.2

package/README.md

@@ -1,14 +1,22 @@
 # @agentskit/cli
 
-![stability: stable](https://img.shields.io/badge/stability-stable-brightgreen)
-
 Chat with any LLM, scaffold projects, and run agents — all from your terminal.
 
-## Why
+[![npm version](https://img.shields.io/npm/v/@agentskit/cli?color=blue)](https://www.npmjs.com/package/@agentskit/cli)
+[![npm downloads](https://img.shields.io/npm/dm/@agentskit/cli)](https://www.npmjs.com/package/@agentskit/cli)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/@agentskit/cli)](https://bundlephobia.com/package/@agentskit/cli)
+[![license](https://img.shields.io/npm/l/@agentskit/cli)](../../LICENSE)
+[![stability](https://img.shields.io/badge/stability-stable-brightgreen)](../../docs/STABILITY.md)
+[![GitHub stars](https://img.shields.io/github/stars/AgentsKit-io/agentskit?style=social)](https://github.com/AgentsKit-io/agentskit)
+
+**Tags:** `ai` · `agents` · `llm` · `agentskit` · `openai` · `anthropic` · `claude` · `gemini` · `chatgpt` · `cli` · `command-line` · `scaffolding` · `ai-agents` · `autonomous-agents`
+
+## Why cli
 
 - **Zero setup for prototyping** — go from idea to running conversation in under a minute; no boilerplate, no config files to write
 - **Scaffold production-ready projects** — generate a React chat app or terminal agent with the right structure so you skip the boring setup
 - **Script and automate** — pipe inputs, use env vars for keys, and compose with other Unix tools for lightweight agent scripting
+- **Every provider, one command** — switch between OpenAI, Anthropic, Ollama (local), and more with a single flag
 
 ## Install
 
@@ -35,9 +43,13 @@ agentskit init --template ink --dir my-cli
 agentskit run --help
 ```
 
-## Next steps
+## Features
 
-- Generated apps use [`@agentskit/react`](https://www.npmjs.com/package/@agentskit/react) or [`@agentskit/ink`](https://www.npmjs.com/package/@agentskit/ink) — extend with [`@agentskit/tools`](https://www.npmjs.com/package/@agentskit/tools), [`@agentskit/skills`](https://www.npmjs.com/package/@agentskit/skills), and [`@agentskit/runtime`](https://www.npmjs.com/package/@agentskit/runtime) for programmatic agents
+- `agentskit chat` — interactive streaming chat in the terminal powered by `@agentskit/ink`
+- `agentskit init` — interactive project generator (React or Ink templates, production-ready structure)
+- `agentskit run` — execute headless runtime agents from the terminal
+- Provider flags: `--provider`, `--model`, `--system`, `--skill`, `--memory`
+- Env-var based key injection — works seamlessly in CI and scripts
 
 ## Ecosystem
 
@@ -48,6 +60,16 @@ agentskit run --help
 | [@agentskit/ink](https://www.npmjs.com/package/@agentskit/ink) | Ink UI used by interactive `chat` |
 | [@agentskit/core](https://www.npmjs.com/package/@agentskit/core) | Shared types and contracts |
 
+## Contributors
+
+<a href="https://github.com/AgentsKit-io/agentskit/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=AgentsKit-io/agentskit" alt="AgentsKit contributors" />
+</a>
+
+## License
+
+MIT — see [LICENSE](../../LICENSE).
+
 ## Docs
 
-[Full documentation](https://emersonbraun.github.io/agentskit/)
+[Full documentation](https://www.agentskit.io) · [GitHub](https://github.com/AgentsKit-io/agentskit)

package/dist/bin.cjs

@@ -386,6 +386,8 @@ function reactStarter(ctx) {
         },
         dependencies: deps,
         devDependencies: {
+          "@types/react": "^19.0.0",
+          "@types/react-dom": "^19.0.0",
           "@vitejs/plugin-react": "^5.0.0",
           typescript: "^5.5.0",
           vite: "^7.0.0"
@@ -491,6 +493,7 @@ function inkStarter(ctx) {
         dependencies: deps,
         devDependencies: {
           "@types/react": "^19.0.0",
+          "@types/react-dom": "^19.0.0",
           tsx: "^4.20.0",
           typescript: "^5.5.0"
         }
@@ -715,9 +718,9 @@ ${runCmd}
 
 ## Next steps
 
-- Open the AgentsKit docs at https://agentskit.io/docs
-- Add a custom skill: https://agentskit.io/docs/concepts/skill
-- Wire up RAG: https://agentskit.io/docs/recipes/rag-chat
+- Open the AgentsKit docs at https://www.agentskit.io/docs
+- Add a custom skill: https://www.agentskit.io/docs/concepts/skill
+- Wire up RAG: https://www.agentskit.io/docs/recipes/rag-chat
 
 ## License
 
@@ -873,7 +876,7 @@ function printNextSteps(options) {
   process.stdout.write(`  ${kleur__default.default.cyan(runCmd)}
 
 `);
-  process.stdout.write(kleur__default.default.dim("  Docs: https://agentskit.io/docs\n\n"));
+  process.stdout.write(kleur__default.default.dim("  Docs: https://www.agentskit.io/docs\n\n"));
 }
 function formatEvent(event) {
   switch (event.type) {
@@ -1039,8 +1042,8 @@ var PROVIDER_ENV_KEYS = {
 };
 var PROVIDER_REACH_URLS = {
   openai: "https://api.openai.com/v1/models",
-  anthropic: "https://api.anthropic.com",
-  gemini: "https://generativelanguage.googleapis.com",
+  anthropic: "https://api.anthropic.com/v1/messages",
+  gemini: "https://generativelanguage.googleapis.com/v1beta/models",
   ollama: "http://localhost:11434/api/tags"
 };
 async function checkNodeVersion() {
@@ -1128,10 +1131,10 @@ async function checkProviderEnv(provider) {
   const value = process.env[envKey];
   if (!value) {
     return {
-      status: "fail",
+      status: "skip",
       name: `${provider} API key`,
-      detail: `${envKey} is not set`,
-      fix: `export ${envKey}=...`
+      detail: `${envKey} not set`,
+      fix: `export ${envKey}=... (only needed if you use ${provider})`
     };
   }
   if (value.length < 16) {
@@ -1147,7 +1150,11 @@ async function checkProviderEnv(provider) {
 async function checkProviderReachable(provider, fetchImpl = fetch, timeoutMs = 4e3) {
   const url = PROVIDER_REACH_URLS[provider];
   if (!url) {
-    return { status: "skip", name: `${provider} reachable`, detail: "No reachability check for this provider" };
+    return { status: "skip", name: `${provider} reachable`, detail: "No reachability check configured" };
+  }
+  const envKey = PROVIDER_ENV_KEYS[provider];
+  if (envKey && !process.env[envKey]) {
+    return { status: "skip", name: `${provider} reachable`, detail: "Skipped \u2014 no API key configured" };
   }
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -1155,12 +1162,18 @@ async function checkProviderReachable(provider, fetchImpl = fetch, timeoutMs = 4
     const res = await fetchImpl(url, {
       method: "GET",
       signal: controller.signal
-      // No auth — we just want to confirm DNS + network reach.
     });
+    if (res.status >= 200 && res.status < 400) {
+      return { status: "pass", name: `${provider} reachable`, detail: `${url} \u2192 ${res.status} OK` };
+    }
+    if (res.status === 401 || res.status === 403 || res.status === 405) {
+      return { status: "pass", name: `${provider} reachable`, detail: `${url} \u2192 ${res.status} (host reachable)` };
+    }
     return {
-      status: "pass",
+      status: "warn",
       name: `${provider} reachable`,
-      detail: `${url} \u2192 HTTP ${res.status}`
+      detail: `${url} \u2192 HTTP ${res.status}`,
+      fix: "Host reachable but returned unexpected status \u2014 check provider docs"
     };
   } catch (err) {
     const reason = err.name === "AbortError" ? `timeout after ${timeoutMs}ms` : err.message;
@@ -1218,41 +1231,69 @@ async function runDoctor(options = {}) {
   };
 }
 var ICON = {
-  pass: "\u2713",
-  warn: "!",
-  fail: "\u2717",
-  skip: "\xB7"
+  pass: "\u2714",
+  warn: "\u26A0",
+  fail: "\u2718",
+  skip: "\u25CB"
 };
 function renderReport(report, opts = {}) {
   const color = opts.color ?? true;
   const c = (code, text) => color ? `\x1B[${code}m${text}\x1B[0m` : text;
   const colorFor = {
     pass: (t) => c("32", t),
+    // green
     warn: (t) => c("33", t),
+    // yellow
     fail: (t) => c("31", t),
+    // red
     skip: (t) => c("90", t)
+    // dim
   };
   const lines = [];
   lines.push("");
-  lines.push(c("1", "agentskit doctor"));
+  lines.push(`  ${c("1;36", "\u26A1 AgentsKit Doctor")}`);
+  lines.push(`  ${c("90", "\u2500".repeat(50))}`);
   lines.push("");
+  const groups = {
+    "Environment": [],
+    "Providers": [],
+    "Network": []
+  };
   for (const r of report.results) {
-    const icon = colorFor[r.status](ICON[r.status]);
-    const name = r.name.padEnd(28);
-    const detail = r.detail ? c("90", r.detail) : "";
-    lines.push(`  ${icon}  ${name} ${detail}`);
-    if (r.fix && (r.status === "fail" || r.status === "warn")) {
-      lines.push(`     ${c("90", "\u21B3 " + r.fix)}`);
+    if (r.name.includes("reachable")) {
+      groups["Network"].push(r);
+    } else if (r.name.includes("API key")) {
+      groups["Providers"].push(r);
+    } else {
+      groups["Environment"].push(r);
     }
   }
-  lines.push("");
-  const summary = [
-    `${report.pass} pass`,
-    report.warn > 0 ? colorFor.warn(`${report.warn} warn`) : `${report.warn} warn`,
-    report.fail > 0 ? colorFor.fail(`${report.fail} fail`) : `${report.fail} fail`,
-    `${report.skip} skip`
-  ].join("  \xB7  ");
-  lines.push(`  ${c("1", "Summary:")} ${summary}`);
+  for (const [group, results] of Object.entries(groups)) {
+    if (results.length === 0) continue;
+    lines.push(`  ${c("1", group)}`);
+    for (const r of results) {
+      const icon = colorFor[r.status](ICON[r.status]);
+      const name = r.name.padEnd(28);
+      const detail = r.detail ? c("90", r.detail) : "";
+      lines.push(`    ${icon}  ${name} ${detail}`);
+      if (r.fix && r.status !== "pass") {
+        lines.push(`       ${c("90", "\u21B3 " + r.fix)}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push(`  ${c("90", "\u2500".repeat(50))}`);
+  const parts = [];
+  if (report.pass > 0) parts.push(colorFor.pass(`${report.pass} passed`));
+  if (report.warn > 0) parts.push(colorFor.warn(`${report.warn} warnings`));
+  if (report.fail > 0) parts.push(colorFor.fail(`${report.fail} failed`));
+  if (report.skip > 0) parts.push(colorFor.skip(`${report.skip} skipped`));
+  lines.push(`  ${parts.join("  \xB7  ")}`);
+  if (report.fail === 0) {
+    lines.push(`  ${c("32", "\u2714 Ready to build agents.")}`);
+  } else {
+    lines.push(`  ${c("31", "\u2718 Fix the issues above before continuing.")}`);
+  }
   lines.push("");
   return lines.join("\n");
 }