@outsidestudio/agent-kit 0.2.0 → 0.2.2

package/README.md

@@ -20,15 +20,16 @@ That command:
 2. Asks once for any secrets the profile needs (API keys, model endpoint) and stores them in `~/.config/outside-agent-kit/env` (chmod 600), loaded from `~/.zshrc` / `~/.bashrc`.
 3. Fetches the **latest** version of every skill and plugin. Nothing is pinned.
 4. Writes each tool's config, keeping anything the developer added themselves.
-5. Installing **only registry items** (no profile) is additive: it adds/replaces those items and keeps the rest of your install. Installing a profile reconciles the full set.
+5. **Installs are additive**: `agent-kit <target>` writes the named profiles/items and never removes anything else you already have — so `agent-kit product-backend` after `agent-kit product-backend web-frontend` just refreshes backend and leaves the web skills in place. To drop something, use `agent-kit remove <target>`; to rebuild configs to exactly your saved set, use `agent-kit update`.
 
 ## Commands
 
 | Command | What it does |
 |---|---|
-| `agent-kit <profile...>` | Install one or more profiles |
-| `agent-kit outside/llm` | Add/refresh a single registry item without touching the rest of the install (see `agent-kit list`) |
-| `agent-kit update` | Re-install the current targets with the latest of everything |
+| `agent-kit add <profile...>` | Add/refresh one or more profiles (additive — keeps the rest). Bare `agent-kit <profile...>` and `install` are shorthands |
+| `agent-kit add outside/llm` | Add/refresh a single registry item on top of what you have (see `agent-kit list`) |
+| `agent-kit remove <target...>` | Remove installed profiles/items; everything else is reconciled to stay |
+| `agent-kit update` | Re-fetch your saved targets and reconcile configs to exactly them (prunes leftovers) |
 | `agent-kit doctor` | Check tools, secrets, model endpoint, MCP servers, skills |
 | `agent-kit secrets` | Enter missing secrets |
 | `agent-kit list` | Show profiles and registry items |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outsidestudio/agent-kit",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "One-command setup of skills, MCP servers and model providers for OpenCode and OMP",
   "type": "module",
   "bin": {

package/src/cli.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { doctor } from "./commands/doctor";
-import { install, secrets, update } from "./commands/install";
+import { install, remove, secrets, update } from "./commands/install";
 import { list } from "./commands/list";
 import { newMcp, newSkill } from "./commands/new";
 import { color, log } from "./log";
@@ -8,8 +8,9 @@ import { color, log } from "./log";
 const HELP = `${color.bold("agent-kit")}: set up skills, MCP servers and models for OpenCode and OMP
 
 ${color.bold("Usage")}
-  agent-kit <target...>            Install profiles and/or single registry items (same as: agent-kit install <target...>)
-  agent-kit update                 Re-install the current targets with the latest of everything
+  agent-kit add <target...>        Add/refresh profiles and/or single registry items; leaves everything else installed untouched (shorthand: agent-kit <target...>, also: agent-kit install)
+  agent-kit remove <target...>     Remove installed profiles/items; the rest is kept and reconciled
+  agent-kit update                 Re-fetch the saved targets and reconcile configs to exactly them
   agent-kit doctor                 Check tools, secrets, model endpoint and MCP servers
   agent-kit secrets                Enter any missing secrets
   agent-kit list                   Show profiles and registry items
@@ -23,9 +24,10 @@ ${color.bold("Options")}
   --no-shell            Don't add the secrets loader to ~/.zshrc / ~/.bashrc
 
 ${color.bold("Examples")}
-  bunx @outsidestudio/agent-kit product-backend
+  bunx @outsidestudio/agent-kit add product-backend   # bare form works too: bunx @outsidestudio/agent-kit product-backend
   bunx @outsidestudio/agent-kit product-backend web-frontend
-  bunx @outsidestudio/agent-kit outside/llm      # just the model provider (see: agent-kit list)
+  bunx @outsidestudio/agent-kit outside/llm      # just the model provider, on top of what's installed (see: agent-kit list)
+  bunx @outsidestudio/agent-kit remove web-frontend   # drop web skills, keep backend + shared
   bunx @outsidestudio/agent-kit update
 `;
 
@@ -57,9 +59,13 @@ async function main() {
   if (!cmd || flags.help) return console.log(HELP);
 
   switch (cmd) {
+    case "add":
     case "install":
       if (!rest.length) throw new Error("What to install? Run: agent-kit list");
       return install(rest, opts);
+    case "remove":
+      if (!rest.length) throw new Error("What to remove? Run: agent-kit list");
+      return remove(rest, opts);
     case "update":
       return update(opts);
     case "doctor":

package/src/commands/install.ts

@@ -11,6 +11,8 @@ export interface InstallOptions {
   tools?: string[];
   yes?: boolean;
   shell?: boolean;
+  /** Rebuild configs from exactly these targets, purging managed leftovers. */
+  reconcile?: boolean;
 }
 
 function pickTools(requested?: string[]): string[] {
@@ -46,10 +48,14 @@ function mergeToolState(prev: ToolState | undefined, next: ToolState): ToolState
 export async function install(targets: string[], opts: InstallOptions = {}) {
   const tools = pickTools(opts.tools);
   const { profiles, items: direct } = await resolveTargets(targets);
-  // Targeting only registry items adds/replaces those items; it never purges
-  // the rest of the install. A profile target still reconciles the full set.
-  const additive = profiles.length === 0 && direct.length > 0;
-  log.head(`Setting up ${targets.map((t) => `"${t}"`).join(" + ")} for ${tools.join(" + ")}`);
+  // Installs are additive: they add/refresh the named targets and never touch
+  // what else is installed. Only --reconcile runs (update, remove) purge.
+  const additive = opts.reconcile !== true;
+  log.head(
+    targets.length
+      ? `Setting up ${targets.map((t) => `"${t}"`).join(" + ")} for ${tools.join(" + ")}`
+      : `Removing everything the kit manages for ${tools.join(" + ")}`,
+  );
 
   const ids = [...new Set([...(await resolveProfiles(profiles)), ...direct])];
   const items = await Promise.all(ids.map(loadItem));
@@ -101,7 +107,10 @@ export async function install(targets: string[], opts: InstallOptions = {}) {
     managed: { ...(prev?.managed ?? {}) },
     installed: additive ? { ...(prev?.installed ?? {}), ...plan.fetched } : plan.fetched,
   };
-  if (additive && prev) log.step(`Additive: keeping ${prev.profiles.join(", ") || "existing items"}; replacing ${direct.join(", ")}`);
+  if (additive && prev)
+    log.step(
+      `Additive: keeping ${[...prev.profiles, ...prev.items].join(", ") || "nothing"}; refreshing ${targets.join(", ")}`,
+    );
   for (const t of tools) {
     const next = await adapters[t].apply(plan, prev?.managed[t]);
     state.managed[t] = additive ? mergeToolState(prev?.managed[t], next) : next;
@@ -124,7 +133,31 @@ export async function install(targets: string[], opts: InstallOptions = {}) {
 export async function update(opts: InstallOptions = {}) {
   const prev = await readState();
   if (!prev) throw new Error("Nothing installed yet. Run: agent-kit <profile>");
-  await install([...prev.profiles, ...prev.items], { ...opts, tools: opts.tools ?? prev.tools });
+  // Reconcile: the saved targets are the whole truth, so leftovers from
+  // changed profile definitions get purged.
+  await install([...prev.profiles, ...prev.items], {
+    ...opts,
+    tools: opts.tools ?? prev.tools,
+    reconcile: true,
+  });
+}
+
+/** Drop targets from the saved install; everything else is reconciled to stay. */
+export async function remove(targets: string[], opts: InstallOptions = {}) {
+  const prev = await readState();
+  if (!prev) throw new Error("Nothing installed yet. Run: agent-kit <profile>");
+  await resolveTargets(targets); // reject unknown names
+  const saved = [...prev.profiles, ...prev.items];
+  const gone = targets.filter((t) => saved.includes(t));
+  if (!gone.length)
+    throw new Error(
+      `None of ${targets.join(", ")} is installed. Installed: ${saved.join(", ") || "nothing"}. ` +
+        `Items pulled in by a profile can only be removed by removing that profile.`,
+    );
+  const rest = saved.filter((t) => !gone.includes(t));
+  log.head(`Removing ${gone.join(", ")}`);
+  if (rest.length) log.info(`Keeping: ${rest.join(", ")}`);
+  await install(rest, { ...opts, tools: opts.tools ?? prev.tools, reconcile: true });
 }
 
 /** Re-prompt for every secret the current install needs. */

package/src/types.ts

@@ -95,8 +95,10 @@ export interface Plan {
   /** What was fetched, for the install log. */
   fetched: Record<string, string>;
   /**
-   * Single registry-item install: replace only the items in this plan and
-   * keep everything else the kit managed before (no purge of skills/MCP/etc).
+   * Additive run (the default for installs): write exactly what this plan
+   * names and keep every other entry the kit managed before — no purge of
+   * skills/MCP/plugins/providers. Reconcile runs (update, remove) leave this
+   * false and rebuild the config from only this plan.
    */
   additive?: boolean;
 }