@schuttdev/kon 0.2.7 → 0.2.9

package/dist/index.js

@@ -136,7 +136,7 @@ var ScriptToolConfigSchema = z.object({
 var BuiltinToolConfigSchema = z.object({
   type: z.literal("builtin"),
   name: z.string(),
-  builtin: z.enum(["filesystem", "shell"]),
+  builtin: z.enum(["filesystem", "shell", "read", "write", "edit", "glob", "grep", "bash"]),
   description: z.string(),
   config: z.record(z.unknown()).optional()
 });
@@ -321,7 +321,7 @@ function createHttpClient(serverUrl, sessionToken) {
 }
 
 // ../cli/src/version.ts
-var VERSION = "0.2.7";
+var VERSION = "0.2.9";
 
 // ../cli/src/connect.ts
 async function connect(serverName) {
@@ -430,34 +430,61 @@ kon connect
 
 If \`kon connect\` succeeds, you are ready to use tools. If it fails, tell the user.
 
-## Usage
+## Discovering tools
 
-### List available tools
+List all available tools:
 \`\`\`bash
 kon list
 \`\`\`
 
-### Run a tool
+Get detailed help for a specific tool:
 \`\`\`bash
-kon <tool-name> [args...]
+kon help <tool-name>
 \`\`\`
 
-Examples:
+## Core tools
+
+These tools may be available depending on the server's configuration. Run \`kon list\` to see what's enabled.
+
+### read \u2014 Read file contents
 \`\`\`bash
-kon shell date
-kon fs list Documents
-kon shell whoami
+kon read <file> [offset] [limit]
 \`\`\`
+- \`offset\`: start from this line number (0-based)
+- \`limit\`: max number of lines to return
 
-### Get help for a tool
+### write \u2014 Write content to a file
 \`\`\`bash
-kon help <tool-name>
+kon write <file> <content>
 \`\`\`
 
-### Switch server (if multiple are configured)
+### edit \u2014 Replace text in a file
 \`\`\`bash
-kon connect <server-name>
+kon edit <file> <old_string> <new_string> [--all]
+\`\`\`
+- Without \`--all\`: fails if old_string matches multiple locations (provide more context)
+- With \`--all\`: replaces every occurrence
+
+### glob \u2014 Find files by pattern
+\`\`\`bash
+kon glob <pattern> [path]
+\`\`\`
+- Supports \`*\`, \`**\`, \`?\`, \`{a,b}\` syntax
+- Example: \`kon glob "**/*.ts" ~/projects/myapp\`
+
+### grep \u2014 Search file contents
+\`\`\`bash
+kon grep <pattern> [path] [--glob <filter>] [-i] [-n] [-C <num>]
+\`\`\`
+- Uses ripgrep if available, falls back to built-in search
+- Example: \`kon grep "TODO" ~/projects --glob "*.ts"\`
+
+### bash \u2014 Execute shell commands
+\`\`\`bash
+kon bash <command> [args...]
 \`\`\`
+- Commands are restricted to the server's allowlist
+- Example: \`kon bash git status\`
 
 ### File transfer
 \`\`\`bash
@@ -465,6 +492,26 @@ kon upload <file>
 kon download <id> <dest>
 \`\`\`
 
+## Other tools
+
+The server may have additional tools registered (CLI commands, MCP servers, scripts). Any unknown subcommand is treated as a tool name:
+
+\`\`\`bash
+kon <tool-name> [args...]
+\`\`\`
+
+For MCP tools, the first arg is the MCP tool name:
+\`\`\`bash
+kon <mcp-tool> <mcp-action> [json-args]
+\`\`\`
+
+## Multiple servers
+
+\`\`\`bash
+kon connect <server-name>
+kon status
+\`\`\`
+
 ## Important
 
 - Always run the setup block before first use in a new conversation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schuttdev/kon",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "type": "module",
   "description": "Lightweight gigai client for Claude code execution",
   "bin": {