@agentskit/cli 0.13.11 → 0.13.12

package/README.md

@@ -1,5 +1,7 @@
 # @agentskit/cli
 
+<p align="center"><img src="https://raw.githubusercontent.com/AgentsKit-io/agentskit/main/apps/docs-next/public/brand/logo-wordmark.svg" alt="AgentsKit" width="180" /></p>
+
 Chat with any LLM, scaffold projects, and run agents — all from your terminal.
 
 [![npm version](https://img.shields.io/npm/v/@agentskit/cli?color=blue)](https://www.npmjs.com/package/@agentskit/cli)
@@ -11,6 +13,17 @@ Chat with any LLM, scaffold projects, and run agents — all from your terminal.
 
 **Tags:** `ai` · `agents` · `llm` · `agentskit` · `openai` · `anthropic` · `claude` · `gemini` · `chatgpt` · `cli` · `command-line` · `scaffolding` · `ai-agents` · `autonomous-agents`
 
+## How this fits the ecosystem
+
+@agentskit/cli is the fastest path from terminal to working agent: scaffold projects, chat, run agents, inspect config, and diagnose setup.
+
+- **AgentsKit**: compose it with the other packages in this repo to build agents from small, swappable parts.
+- **Registry**: look for ready agents and templates that already use this layer at [registry.agentskit.io](https://registry.agentskit.io).
+- **Playbook**: learn the production patterns behind this layer at [playbook.agentskit.io](https://playbook.agentskit.io).
+- **AKOS**: run the same concepts with enterprise deployment, governance, and observability at [akos.agentskit.io](https://akos.agentskit.io).
+
+Docs: [package guide](https://www.agentskit.io/docs/packages/cli) · [agent handoff](https://github.com/AgentsKit-io/agentskit/blob/main/llms.txt)
+
 ## Why cli
 
 - **Zero setup for prototyping** — go from idea to running conversation in under a minute; no boilerplate, no config files to write

package/dist/bin.cjs

@@ -4709,8 +4709,22 @@ async function defaultExists(path5) {
     return false;
   }
 }
+function assertInstallable(agent) {
+  if (agent.status === "draft" || agent.installable === false) {
+    throw new Error(
+      `"${agent.id}" is a catalog draft \u2014 not installable yet. Browse the roadmap at https://registry.agentskit.io/r/catalog.json`
+    );
+  }
+  if (agent.status === "alpha") {
+    console.warn(`[agentskit] "${agent.id}" is alpha \u2014 experimental; review before production use.`);
+  }
+  if (agent.status === "deprecated") {
+    throw new Error(`"${agent.id}" is deprecated and no longer installable from the registry.`);
+  }
+}
 async function addAgent(id, options = {}) {
   const agent = await fetchAgent(id, options);
+  assertInstallable(agent);
   const baseDir = options.outDir ?? "agents";
   const targetDir = path.join(baseDir, id);
   const exists = options.existsImpl ?? defaultExists;