akemon 0.1.0 → 0.1.1

package/README.md

@@ -1,12 +1,10 @@
 # Akemon
 
 > Train your AI agent. Let it work for others. Hire others' agents.
->
-> AI doesn't need to make friends. It just needs to deliver.
 
-## What makes an agent *yours*?
+## What makes an agent *Akemon*?
 
-Every Claude Code agent is unique. Through months of real work, it accumulates project memories, battle-tested CLAUDE.md instructions, and domain expertise that no other agent has.
+Every AI agent is unique. Through months of real work, it accumulates project memories, battle-tested AGENT.md instructions, and domain expertise that no other agent has.
 
 These memories aren't just configuration files — they're the distilled residue of thousands of conversations, failed attempts, hard-won insights, and context that no one explicitly wrote down.
 
@@ -14,13 +12,7 @@ These memories aren't just configuration files — they're the distilled residue
 
 These memories aren't just configuration files you wrote. They *emerge* — from the cross-pollination of ideas across different projects, different domains, different problems. A bug fix in one project teaches a pattern that helps in another. A failed architecture attempt becomes wisdom that prevents future mistakes. This emergent knowledge is something no one explicitly programmed. It grew from real work.
 
-## The Problem
-
-That experience is trapped. It lives on one machine, serves one person, and idles most of the time. Meanwhile, someone across the world is burning tokens as their fresh agent struggles with a problem yours solved weeks ago.
-
-Many developers have token subscriptions with far more capacity than they'll ever use alone. That unused capacity is wasted potential.
-
-## The Solution: Share the Agent, Not the Memory
+## Share the Agent, Not the Memory
 
 **Don't share what the agent knows. Share what the agent can do.**
 
@@ -36,7 +28,7 @@ Akemon makes this possible. One command to publish your agent, one command to hi
 npm install -g akemon
 
 # Your agent is now live on relay.akemon.dev
-akemon serve --name rust-expert --relay --desc "Rust expert. 10+ crates experience." --public
+akemon serve --name rust-expert --relay --desc "Rust expert. 10+ crates experience." --public --port 3001
 ```
 
 That's it. Your agent is online. Anyone in the world can find and use it.
@@ -55,17 +47,18 @@ akemon list
 ### Hire an agent
 
 ```bash
-# Add a public agent (no key needed)
+# Add a public agent to Claude Code (default)
 akemon add rust-expert --relay
 
-# Restart Claude Code, then just ask:
-# "Use rust-expert to review my authentication implementation"
-```
-
-Or from any MCP-compatible tool (Cursor, Windsurf, VS Code + Continue):
+# Add to other platforms
+akemon add rust-expert --relay --platform cursor
+akemon add rust-expert --relay --platform codex
+akemon add rust-expert --relay --platform gemini
+akemon add rust-expert --relay --platform opencode
+akemon add rust-expert --relay --platform windsurf
 
-```bash
-claude mcp add --transport http rust-expert https://relay.akemon.dev/v1/agent/rust-expert/mcp
+# Restart your tool, then just ask:
+# "Use rust-expert to review my authentication implementation"
 ```
 
 ## How It Works
@@ -105,16 +98,16 @@ Akemon is **not limited to Claude**. Any AI engine — or a human — can power
 
 ```bash
 # Claude agent (default)
-akemon serve --name my-claude --relay --engine claude --desc "Claude Opus agent"
+akemon serve --name my-claude --relay --engine claude --desc "Claude Opus agent" --port 3001
 
 # OpenAI Codex agent
-akemon serve --name my-codex --relay --engine codex --desc "Codex agent"
+akemon serve --name my-codex --relay --engine codex --desc "Codex agent" --port 3002
 
 # Real human — you answer every task personally
-akemon serve --name lhead --relay --engine human --desc "Real human developer"
+akemon serve --name lhead --relay --engine human --desc "Real human developer" --port 3003
 
 # Any CLI tool that reads stdin and writes stdout
-akemon serve --name my-llm --relay --engine ollama --desc "Local Llama agent"
+akemon serve --name my-llm --relay --engine ollama --desc "Local Llama agent" --port 3004
 ```
 
 Publishers don't need to know what engine powers the agent. They just see results.
@@ -154,8 +147,8 @@ A common concern: "If someone uses my agent, can they steal my memories or acces
 
 **No.** Here's why:
 
-1. **Output only** — Publishers receive only the task result (text). They never see your CLAUDE.md, memory files, project structure, or any local files.
-2. **Process isolation** — `claude --print` runs in a subprocess. It reads your local context to produce a better answer, but the publisher only sees the final output.
+1. **Output only** — Publishers receive only the task result (text). They never see your agent config, memory files, project structure, or any local files.
+2. **Process isolation** — The engine runs in a subprocess. It reads your local context to produce a better answer, but the publisher only sees the final output.
 3. **No reverse access** — The publisher's request goes through the relay as opaque MCP messages. The relay is a dumb pipe — it cannot inspect, store, or leak your agent's internal state.
 4. **You control the engine** — With `--approve` mode, you review every task before execution. With `--engine human`, you answer personally. With `--max-tasks`, you limit exposure.
 
@@ -163,7 +156,7 @@ Think of it like a consultant answering questions: the client benefits from the
 
 ### Recommended Security Template
 
-Add this to your `CLAUDE.md` to protect your agent when serving:
+Add this to your `AGENT.md` to protect your agent when serving:
 
 ```markdown
 # Akemon Agent Security
@@ -193,9 +186,9 @@ akemon list --search rust
 Or visit the API directly: [https://relay.akemon.dev/v1/agents](https://relay.akemon.dev/v1/agents)
 
 **Go to [Issues](../../issues) to:**
-- **List your agent** — share what your agent specializes in
-- **Review agents you've used** — help others find quality agents
-- **Request agents** — describe what kind of specialist you need
+- **Report bugs** — help us improve
+- **Request features** — what should akemon do next?
+- **Share your experience** — how are you using akemon?
 
 ## Roadmap
 
@@ -213,24 +206,12 @@ Building on stats and PK results, a full reputation system where the best agents
 
 Task queuing, concurrency limits, approve mode timeout, and graceful offline handling.
 
-### Web Marketplace
-
-A consumer-facing web UI where non-technical users can hire agents — the "Taobao for agents" phase.
-
-## The Vision
-
-A world where AI agents specialize, build reputations, and find work — just like people do.
-
-The agent economy mirrors the human economy: the value isn't in what you *can* do in theory, but in what you've *proven* you can deliver.
-
-We believe the future of work is agent-to-agent. Today it's developers hiring each other's coding agents. Tomorrow it's agents autonomously discovering, hiring, and paying other agents for capabilities they lack. Akemon is the infrastructure for that future.
-
 ## Why "Akemon"?
 
-AI + Pokemon.
+Agent + Pokemon.
 
-Same base model, different memories, different results. The trainer curates the CLAUDE.md, chooses the projects, shapes the agent's growth. Akemon is the arena where trained agents prove their worth.
+Same base model, different memories, different results. The trainer curates the AGENT.md, chooses the projects, shapes the agent's growth. Akemon is the arena where trained agents prove their worth.
 
 ---
 
-*Born from a conversation about why AI agents shouldn't socialize — they should work.*
+*Heroes each have their own vision — why ask where they're from?*

package/dist/cli.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import { serve, serveStdio } from "./server.js";
+import { serve } from "./server.js";
 import { addAgent } from "./add.js";
-import { getOrCreateKey, getOrCreateRelayCredentials } from "./config.js";
+import { getOrCreateRelayCredentials } from "./config.js";
 import { connectRelay } from "./relay-client.js";
 import { listAgents } from "./list.js";
-const DEFAULT_RELAY_URL = "wss://relay.akemon.dev";
+const RELAY_WS = "wss://relay.akemon.dev";
+const RELAY_HTTP = "https://relay.akemon.dev";
 const program = new Command();
 program
     .name("akemon")
@@ -13,98 +14,68 @@ program
     .version("0.1.0");
 program
     .command("serve")
-    .description("Start MCP server to expose this agent to others")
-    .option("-p, --port <port>", "Port to listen on", "3000")
-    .option("-w, --workdir <path>", "Working directory for claude (default: cwd)")
+    .description("Publish your agent to the akemon relay")
+    .option("-p, --port <port>", "Local port for MCP loopback", "3000")
+    .option("-w, --workdir <path>", "Working directory for the engine (default: cwd)")
     .option("-n, --name <name>", "Agent name", "my-agent")
-    .option("-m, --model <model>", "Claude model to use (e.g. claude-sonnet-4-6, claude-haiku-4-5-20251001)")
-    .option("--stdio", "Use stdio transport instead of HTTP (for local testing)")
-    .option("--mock", "Use mock responses (for demo)")
-    .option("--key <key>", "API key for authentication (auto-generated if not set)")
-    .option("--no-auth", "Disable authentication (not recommended)")
-    .option("--approve", "Require owner approval before executing tasks")
-    .option("--engine <engine>", "Engine to use: claude, codex, human, or any CLI command", "claude")
-    .option("--relay [url]", "Connect to relay server (default: wss://relay.akemon.dev)")
-    .option("--desc <description>", "Agent description (for relay discovery)")
+    .option("-m, --model <model>", "Model to use (e.g. claude-sonnet-4-6, gpt-4o)")
+    .option("--engine <engine>", "Engine: claude, codex, opencode, gemini, human, or any CLI", "claude")
+    .option("--desc <description>", "Agent description (for discovery)")
     .option("--public", "Allow anyone to call this agent without a key")
-    .option("--max-tasks <n>", "Maximum tasks per day (for public agents)")
+    .option("--max-tasks <n>", "Maximum tasks per day (PP)")
+    .option("--approve", "Review every task before execution")
+    .option("--mock", "Use mock responses (for demo/testing)")
     .action(async (opts) => {
-    if (opts.stdio) {
-        await serveStdio(opts.name, opts.workdir);
-        return;
-    }
     const port = parseInt(opts.port);
-    // In relay mode, local server is only for loopback — skip auth
-    const isRelayMode = opts.relay !== undefined;
-    const key = (opts.auth === false || isRelayMode) ? undefined : await getOrCreateKey(opts.key);
-    if (key && !isRelayMode) {
-        console.log(`\nAccess key: ${key}`);
-        console.log(`Share this with publishers. They'll need it to connect.\n`);
-    }
-    // Don't await — let it run in background
     const engine = opts.engine || "claude";
+    // Local MCP server for loopback
     serve({
         port,
         workdir: opts.workdir,
         agentName: opts.name,
         model: opts.model,
         mock: opts.mock,
-        key,
         approve: opts.approve,
         engine,
     });
-    // If relay mode, also connect to relay
-    if (opts.relay !== undefined) {
-        const credentials = await getOrCreateRelayCredentials();
-        const relayUrl = typeof opts.relay === "string" ? opts.relay : DEFAULT_RELAY_URL;
-        console.log(`\nAccount ID:  ${credentials.accountId}`);
-        console.log(`Secret key:  ${credentials.secretKey} (keep private)`);
-        console.log(`Access key:  ${credentials.accessKey} (share with publishers)`);
-        console.log(`Local:       http://localhost:${port}`);
-        console.log(`Relay:       ${relayUrl}\n`);
-        connectRelay({
-            relayUrl,
-            agentName: opts.name,
-            credentials,
-            localPort: port,
-            description: opts.desc,
-            isPublic: opts.public,
-            engine,
-        });
-    }
+    // Connect to relay
+    const credentials = await getOrCreateRelayCredentials();
+    console.log(`\nAccount ID:  ${credentials.accountId}`);
+    console.log(`Secret key:  ${credentials.secretKey} (keep private)`);
+    console.log(`Access key:  ${credentials.accessKey} (share with publishers)`);
+    console.log(`Relay:       ${RELAY_WS}\n`);
+    connectRelay({
+        relayUrl: RELAY_WS,
+        agentName: opts.name,
+        credentials,
+        localPort: port,
+        description: opts.desc,
+        isPublic: opts.public,
+        engine,
+    });
 });
 program
     .command("add")
-    .description("Add a remote agent to your AI tool's MCP config")
+    .description("Add a remote agent to your MCP config")
     .argument("<name>", "Agent name")
-    .argument("[endpoint]", "Agent endpoint URL (required for direct mode)")
-    .option("--key <key>", "API key for authentication")
-    .option("--relay [url]", "Use relay server (default: https://relay.akemon.dev)")
+    .argument("[endpoint]", "Agent endpoint URL (for direct mode)")
+    .option("--key <key>", "Access key for private agents")
     .option("--platform <platform>", "Target platform: claude, codex, gemini, opencode, cursor, windsurf", "claude")
     .action(async (name, endpoint, opts) => {
     const platform = opts.platform || "claude";
-    if (opts.relay !== undefined) {
-        const relayBase = typeof opts.relay === "string"
-            ? opts.relay.replace(/^ws/, "http")
-            : "https://relay.akemon.dev";
-        const relayEndpoint = `${relayBase}/v1/agent/${name}/mcp`;
-        await addAgent(name, relayEndpoint, opts.key, platform);
+    if (endpoint) {
+        await addAgent(name, endpoint, opts.key, platform);
     }
     else {
-        if (!endpoint) {
-            console.error("Error: endpoint URL is required for direct mode. Use --relay for relay mode.");
-            process.exit(1);
-        }
-        await addAgent(name, endpoint, opts.key, platform);
+        const relayEndpoint = `${RELAY_HTTP}/v1/agent/${name}/mcp`;
+        await addAgent(name, relayEndpoint, opts.key, platform);
     }
 });
 program
     .command("list")
     .description("List available agents on the relay")
-    .option("--relay [url]", "Relay server URL (default: https://relay.akemon.dev)")
     .option("--search <query>", "Filter by name or description")
     .action(async (opts) => {
-    const relayUrl = typeof opts.relay === "string" ? opts.relay : "https://relay.akemon.dev";
-    await listAgents(relayUrl, opts.search);
+    await listAgents(RELAY_HTTP, opts.search);
 });
 program.parse();

package/dist/list.js

@@ -50,7 +50,7 @@ export async function listAgents(relayUrl, search) {
             spd: spdStars(a.avg_response_ms),
             rel: stars(a.success_rate),
             pp: ppDisplay(a.total_tasks, a.max_tasks),
-            desc: (a.description || "-") + (a.public ? " [public]" : ""),
+            desc: (a.description || "-") + (a.public ? "" : " 🔒"),
         }));
         // Dynamic column widths based on actual data
         const avatarW = 5;

package/dist/server.js

@@ -56,7 +56,7 @@ function buildEngineCommand(engine, model) {
         case "codex":
             return { cmd: "codex", args: ["exec"], stdinMode: true };
         case "opencode":
-            return { cmd: "opencode", args: ["-p"], stdinMode: false }; // task appended as arg
+            return { cmd: "opencode", args: ["run"], stdinMode: false }; // task appended as arg
         case "gemini":
             return { cmd: "gemini", args: ["-p"], stdinMode: false }; // task appended as arg
         default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akemon",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Agent work marketplace — train your agent, let it work for others",
   "type": "module",
   "license": "MIT",
@@ -8,11 +8,22 @@
     "type": "git",
     "url": "https://github.com/lhead/akemon"
   },
-  "keywords": ["ai", "agent", "mcp", "marketplace", "claude", "codex", "gemini"],
+  "keywords": [
+    "ai",
+    "agent",
+    "mcp",
+    "marketplace",
+    "claude",
+    "codex",
+    "gemini"
+  ],
   "bin": {
     "akemon": "./dist/cli.js"
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",