edgecrab-sdk
Node.js SDK for EdgeCrab — a Rust-native autonomous coding agent.
Install
npm install edgecrab-sdkQuick Start
Agent API (recommended)
import { Agent } from 'edgecrab-sdk';
const agent = new Agent({
model: 'anthropic/claude-sonnet-4-20250514',
systemPrompt: 'You are a helpful coding assistant',
apiKey: 'your-api-key', // optional
});
// Simple chat with conversation history
const reply = await agent.chat('Explain Rust ownership');
console.log(reply);
// Continue the conversation
const followUp = await agent.chat('Give me an example');
console.log(followUp);Full conversation run
const result = await agent.run('Refactor this function for better error handling');
console.log(result.response);
console.log(`Turns: ${result.turnsUsed}, Tokens: ${result.usage.total_tokens}`);Streaming
for await (const token of agent.stream('Write a haiku about Rust')) {
process.stdout.write(token);
}Low-level client
import { EdgeCrabClient } from 'edgecrab-sdk';
const client = new EdgeCrabClient({
baseUrl: 'http://127.0.0.1:8642',
apiKey: 'your-key',
});
const resp = await client.createCompletion(
[{ role: 'user', content: 'Hello' }],
{ model: 'anthropic/claude-sonnet-4-20250514' },
);
console.log(resp.choices[0].message.content);CLI
edgecrab chat "What is the meaning of life?"
edgecrab chat --model gpt-4 --system "Be concise" "Explain monads"
edgecrab chat --stream "Tell me a story"
edgecrab models
edgecrab healthEnvironment Variables
| Variable | Description |
|---|---|
EDGECRAB_BASE_URL |
API server URL (default: http://127.0.0.1:8642) |
EDGECRAB_API_KEY |
Bearer token for authentication |
API Reference
Agent
| Method | Description |
|---|---|
chat(message) |
Send a message, return reply string. Maintains history. |
run(message) |
Full conversation run — returns AgentResult |
stream(message) |
Async generator yielding tokens |
addMessage(role, content) |
Inject a message into history |
reset() |
Clear history and start a new session |
getMessages() |
Get conversation history |
getTurnCount() |
Number of completed turns |
getUsage() |
Accumulated token usage |
listModels() |
List available models |
health() |
Check server health |
EdgeCrabClient
Lower-level HTTP client with chat(), createCompletion(), streamCompletion(), listModels(), health().