npm install -g tinycrab

npm install tinycrab

# 1. Set API key
export OPENAI_API_KEY=sk-xxx

# 2. Spawn an agent (this starts an HTTP server for this agent)
tinycrab spawn worker

# 3. Chat with it
tinycrab chat worker "Create a Python script that reads CSV files"

# 4. Continue the conversation (use session ID from previous response)
tinycrab chat worker "Now add error handling" -s <session-id>

# 5. Clean up when done
tinycrab cleanup worker

import { Tinycrab } from 'tinycrab';

const tc = new Tinycrab({
  apiKey: process.env.OPENAI_API_KEY,
});

// Spawn agent
const agent = await tc.agent('worker');

// Chat
const result = await agent.chat('Create a Python script');
console.log(result.response);
console.log(result.sessionId); // save this for follow-up

// Continue conversation
await agent.chat('Add error handling', { sessionId: result.sessionId });

// Clean up
await agent.destroy({ cleanup: true });

# Spawn first (this starts HTTP server on a port, e.g., 9000)
tinycrab spawn worker
# Output: Server running on port 9000

# Then call HTTP
curl -X POST http://localhost:9000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello"}'

# Response: {"response": "...", "session_id": "abc123"}

docker run -p 8080:8080 -e OPENAI_API_KEY=sk-xxx ghcr.io/jt-wang/tinycrab

// Request
{"message": "your message", "session_id": "optional"}

// Response
{"response": "agent response", "session_id": "abc123"}