feat: Add API skill with OpenAPI/Restish integration

- Add /api skill for zero-code API integration via OpenAPI specs
- Implement API auto-discovery from URLs (GCP, Railway, GitHub, Stripe, etc.)
- Create CLI commands: api add, list, describe, exec, discover
- Support REST, GraphQL, and Google Discovery format APIs
- Update shell keybindings (Shift+Tab → request, Tab → accept)
- Add comprehensive spec document for Specish API patterns

Supported services:
- REST: GitHub, Stripe, Twilio, Slack, Discord, OpenAI, Anthropic, etc.
- GraphQL: Railway, Linear
- Google Discovery: GCP Compute, Storage, Cloud Run, BigQuery, AI Platform

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: jonathanpeterwu

.claude/commands/api.md

@@ -0,0 +1,72 @@
+# /api - OpenAPI-Based API Access
+
+Execute API calls using OpenAPI specifications via Restish.
+
+## Usage
+
+```bash
+# Register an API
+stackmemory api add <name> <base-url> [--spec <openapi-url>] [--auth-type api-key]
+
+# List registered APIs
+stackmemory api list
+
+# Execute API call
+stackmemory api exec <name> <path> [--param value...]
+
+# Configure authentication
+stackmemory api auth <name> --token <token> --env-var <VAR_NAME>
+```
+
+## Examples
+
+### GitHub API
+
+```bash
+# Register
+stackmemory api add github https://api.github.com
+
+# Auth (optional)
+stackmemory api auth github --token "$GITHUB_TOKEN" --env-var GITHUB_TOKEN
+
+# Execute
+stackmemory api exec github /repos/anthropics/anthropic-sdk-python
+stackmemory api exec github /users/octocat
+stackmemory api exec github /search/repositories --q "language:typescript stars:>1000"
+```
+
+### Linear API
+
+```bash
+# Register
+stackmemory api add linear https://api.linear.app --auth-type api-key
+
+# Auth
+stackmemory api auth linear --token "$LINEAR_API_KEY" --env-var LINEAR_API_KEY
+
+# Execute (GraphQL via POST)
+stackmemory api exec linear /graphql
+```
+
+## How It Works
+
+1. **Registration**: Stores API config in `~/.stackmemory/api-registry.json` and configures Restish
+2. **Auth**: Injects tokens from environment variables into request headers
+3. **Execution**: Uses Restish CLI for HTTP requests with automatic JSON parsing
+4. **Output**: Returns JSON response data
+
+## Requirements
+
+- Restish CLI: `brew install restish`
+
+## Integration
+
+This skill integrates with StackMemory's context system to:
+- Track API calls in session history
+- Enable context-aware suggestions for common operations
+- Store API responses for later retrieval
+
+## See Also
+
+- [Restish Documentation](https://rest.sh/)
+- [OpenAPI Specification](https://swagger.io/specification/)

.ralph/history/iteration-000/artifacts.json

@@ -1,41 +1,29 @@
 {
   "analysis": {
-    "filesCount": 3,
-    "testsPass": 3,
-    "testsFail": 2,
-    "lastChange": "f3e1fef fix: Update CLI version to match package.json 0.4.2"
+    "filesCount": 7,
+    "testsPass": 10,
+    "testsFail": 1,
+    "lastChange": "Iteration 0 changes"
   },
   "plan": {
-    "summary": "Iteration work based on: ",
+    "summary": "Work for iteration 0",
     "steps": [
-      "Fix issues",
-      "Add features",
-      "Update tests"
+      "Task 0-1",
+      "Task 0-2",
+      "Task 0-3"
     ],
     "priority": "high"
   },
   "changes": [
     {
-      "step": "Fix issues",
-      "timestamp": 1768939666491,
-      "result": "simulated"
-    },
-    {
-      "step": "Add features",
-      "timestamp": 1768939666491,
-      "result": "simulated"
-    },
-    {
-      "step": "Update tests",
-      "timestamp": 1768939666491,
-      "result": "simulated"
+      "step": "Task 0-1",
+      "timestamp": 1768986932624,
+      "result": "completed"
     }
   ],
   "validation": {
     "testsPass": true,
     "lintClean": true,
-    "errors": [
-      "Some tests failed"
-    ]
+    "errors": []
   }
 }

.ralph/iteration.txt

@@ -1 +1 @@
-0
+10

.ralph/state.json

@@ -1,5 +1,6 @@
 {
-  "startTime": 1768987694285,
-  "task": "Implement missing SwarmCoordinator methods (getSwarmStatus, getAllActiveSwarms, stopSwarm, forceStop",
-  "status": "initialized"
+  "task": "Test multiple iterations beyond 5",
+  "iteration": 10,
+  "status": "running",
+  "startTime": 1768986932623
 }