agentgate 0.1.2 → 0.1.4

package/README.md

@@ -60,21 +60,60 @@ The server runs on port 3050 by default. Set `PORT` environment variable to chan
 3. Add service accounts (OAuth or API tokens depending on service)
 4. Create API keys for your agents via CLI
 
-## API Key Management
+## Using with Clawdbot / OpenClaw
 
-Manage API keys in the admin UI at `/ui/keys`, or via CLI:
+> ⚠️ **IMPORTANT:** Do NOT run agentgate on the same machine as your AI agent (Clawdbot, OpenClaw, etc.). If the agent has local filesystem access, it could read the database directly and bypass all security controls. Always run agentgate on a **separate, isolated machine** that agents can only reach over the network.
 
-```bash
-# List all API keys
-npm run keys list
+### Configure Your Agent
+
+Add agentgate to your agent's `TOOLS.md`:
+
+```markdown
+### agentgate
+- Base URL: `https://your-agentgate-server.com`
+- Bearer token: `rms_your_key_here`
+- **URL pattern:** `/api/{service}/{accountName}/...`
+- **Reads (GET):** Execute immediately
+- **Writes (POST/PUT/DELETE):** Queue for human approval
+
+#### Write Queue
+# Submit write request
+POST /api/queue/{service}/{accountName}/submit
+  body: { requests: [{method, path, body}], comment: "why" }
+
+# Check status  
+GET /api/queue/{service}/{accountName}/status/{id}
+```
+
+Or include in your agent's system prompt:
+
+```
+You have access to agentgate at https://your-server.com
+API key: rms_your_key_here
+
+For reads: GET /api/{service}/{account}/path
+For writes: POST to /api/queue/{service}/{account}/submit with {requests, comment}
+
+Always include a clear comment explaining your intent for write operations.
+A human will review and approve before execution.
+```
+
+### Generate a Skill File
 
-# Create a new key
-npm run keys create <name>
+agentgate can generate an [AgentSkill](https://docs.openclaw.ai/tools/skills) compatible file:
 
-# Delete a key
-npm run keys delete <id>
+```bash
+curl -H "Authorization: Bearer rms_your_key" \
+  https://your-server.com/api/skill > SKILL.md
 ```
 
+
+
+## API Key Management
+
+Create and manage API keys for your agents in the admin UI at `/ui/keys`.
+
+
 ## Usage
 
 Agents make requests with the API key in the Authorization header:
@@ -207,10 +246,11 @@ BASE_URL=https://agentgate.yourdomain.com npm start
 ## TODO
 
 - [ ] Per-agent service access control - different agents can access different services/accounts
-
 - [ ] Fine-grained endpoint control per service - whitelist/blacklist individual endpoints (even for read operations)
 
 ## License
 
 ISC
 
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentgate",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "description": "API gateway for AI agents with human-in-the-loop write approval",
   "main": "src/index.js",

package/src/cli.js

@@ -12,9 +12,10 @@ function printUsage() {
   console.log(`
 agentgate - API gateway for AI agents with human-in-the-loop write approval
 
-Usage: agentgate <command> [options]
+Usage: agentgate [command] [options]
 
 Commands:
+  (default)             Start the agentgate server
   start                 Start the agentgate server
   keys list             List all API keys
   keys create <name>    Create a new API key
@@ -25,28 +26,36 @@ Options:
   -h, --help            Show this help message
 
 Examples:
-  agentgate start
+  agentgate
   agentgate start --port 8080
   agentgate keys create my-agent
   agentgate keys list
 `);
 }
 
+async function startServer(args) {
+  // Parse port from args
+  const portIdx = args.findIndex(a => a === '-p' || a === '--port');
+  if (portIdx !== -1 && args[portIdx + 1]) {
+    process.env.PORT = args[portIdx + 1];
+  }
+  
+  // Import and run the server
+  await import('./index.js');
+}
+
 async function main() {
-  if (!command || command === '-h' || command === '--help') {
+  if (command === '-h' || command === '--help') {
     printUsage();
     process.exit(0);
   }
 
-  if (command === 'start') {
-    // Parse port from args
-    const portIdx = args.findIndex(a => a === '-p' || a === '--port');
-    if (portIdx !== -1 && args[portIdx + 1]) {
-      process.env.PORT = args[portIdx + 1];
-    }
-    
-    // Import and run the server
-    await import('./index.js');
+  // Default behavior: start the server
+  if (!command || command === 'start') {
+    await startServer(args);
+  } else if (command === '-p' || command === '--port') {
+    // Handle case where user runs: agentgate -p 8080
+    await startServer([command, ...args]);
   } else if (command === 'keys') {
     const subcommand = args[0];
     const { createApiKey, listApiKeys, deleteApiKey } = await import('./lib/db.js');