@kodycodes/cli 1.0.1 → 1.2.0

package/skills/kody/SKILL.md

@@ -1,59 +1,69 @@
 ---
 name: kody
 description: >
-  Use the Kody CLI to log in, search Kody capabilities, and execute
-  sandboxed modules against kody.codes. Use when the user mentions Kody,
-  kody.codes, durable agent tasks, or wants to search/execute via `kody`.
+  Install Kody as a remote MCP server, then use `search` and `execute`
+  from the host agent. Use when the user mentions Kody, kody.codes,
+  durable agent tasks, or wants to search/execute via Kody.
 ---
 
-# Kody CLI
+# Kody
 
-Kody is a remote MCP personal assistant. This skill uses the `@kodycodes/cli`
-package — a local MCP client — instead of configuring an MCP server by hand.
+Kody is a remote MCP personal assistant. **Long term, install it as an MCP
+server in this agent** and call `search` / `execute` directly. Do not keep
+using the CLI as the everyday interface once the server is connected.
 
-## Install
+`@kodycodes/cli` is a bootstrapper: it writes host MCP config and can act as
+a local client when MCP is not available.
+
+## Install the MCP server (recommended)
 
 ```bash
-npm install -g @kodycodes/cli
-# or
-npx @kodycodes/cli --help
+npx @kodycodes/cli install
 ```
 
-Then install this skill into the current host if it is not already present:
+That command lists **running local** agents and writes each host's remote
+MCP entry for `https://kody.codes/mcp`. Host OAuth stays in that client —
+do not run `kody login` for the host connection.
 
-```bash
-npx @kodycodes/cli skill install
-```
+After install, prefer the Kody MCP tools in this agent:
+
+- `search` — discover capabilities, packages, and entity detail
+- `execute` — run one-off modules against those capabilities
+
+Prefer `search` before `execute`. If Kody is already connected here, skip
+the CLI and use those tools.
+
+For web-based clients (ChatGPT, Claude.ai, Grok), point the user at
+https://kody.codes/onboarding.
 
-## Login
+To copy this skill into Claude Code / Cursor / Agents:
 
 ```bash
-kody login
+npx @kodycodes/cli skill install
 ```
 
-The CLI opens a browser for Kody OAuth (PKCE + Client ID Metadata Documents).
-If a browser cannot open, it prints the URL. Tokens (access + refresh) are
-stored in the OS keychain on macOS, Windows, and Linux. Linux without Secret
-Service falls back to a `0600` file under `$XDG_CONFIG_HOME/kody`.
+## CLI fallback
 
-Never ask the user to paste tokens into chat.
-
-## Use Kody
+Use the CLI only for bootstrap, scripting, or when this agent cannot reach
+Kody over MCP.
 
 ```bash
+npm install -g @kodycodes/cli
+kody login
 kody search "what can you do"
 kody search --domain email
 kody execute --code "import { kody } from 'kody:runtime'\nexport default async function main() { return await kody.search({ query: 'what can you do' }) }"
-```
-
-`search` and `execute` are Kody's only MCP tools. Prefer `kody search` before
-`kody execute`. Add `--json` when you need structured output.
-
-```bash
 kody status
 kody whoami
 kody logout
 ```
 
+The CLI opens a browser for Kody OAuth (PKCE + Client ID Metadata Documents).
+If a browser cannot open, it prints the URL. Tokens (access + refresh) are
+stored in the OS keychain on macOS, Windows, and Linux. Linux without Secret
+Service falls back to a `0600` file under `$XDG_CONFIG_HOME/kody`.
+
+Never ask the user to paste tokens into chat.
+
 Override the MCP URL with `--mcp-url` or `KODY_MCP_URL` for preview or local
 servers. Default: `https://kody.codes/mcp`.