2026-04-07 16:09:41 -04:00
|
|
|
# Alfred Agent
|
2026-04-07 11:23:07 -04:00
|
|
|
|
2026-04-07 16:09:41 -04:00
|
|
|
The autonomous AI agent runtime for Alfred Linux and Alfred IDE.
|
|
|
|
|
|
|
|
|
|
## Architecture
|
|
|
|
|
|
|
|
|
|
- **Multi-provider support**: Anthropic Claude, OpenAI GPT, Groq (via OpenAI-compatible adapter)
|
|
|
|
|
- **14 built-in tools**: File operations, web search, shell execution, code analysis
|
|
|
|
|
- **Session persistence**: Full conversation history stored to disk
|
|
|
|
|
- **7-section system prompt**: Structured reasoning with identity, capabilities, safety guardrails
|
|
|
|
|
|
|
|
|
|
## Source Files
|
|
|
|
|
|
|
|
|
|
| File | Purpose |
|
|
|
|
|
|------|---------|
|
|
|
|
|
| `src/providers.js` | Multi-LLM provider abstraction (Anthropic, OpenAI, Groq) |
|
|
|
|
|
| `src/tools.js` | 14 tool definitions — file I/O, search, shell, analysis |
|
|
|
|
|
| `src/prompt.js` | 7-section system prompt builder |
|
|
|
|
|
| `src/session.js` | Conversation session manager with disk persistence |
|
|
|
|
|
| `src/agent.js` | Core agent loop — tool calling, reasoning, response synthesis |
|
|
|
|
|
| `src/cli.js` | Interactive CLI interface |
|
|
|
|
|
| `src/index.js` | HTTP server (port 3102) with health check and message endpoints |
|
|
|
|
|
|
|
|
|
|
## Running
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# CLI mode
|
|
|
|
|
OPENAI_API_KEY=... node src/cli.js --provider openai --model gpt-4o-mini -m "hello"
|
|
|
|
|
|
|
|
|
|
# Server mode (PM2)
|
|
|
|
|
pm2 start src/index.js --name alfred-agent
|
|
|
|
|
# Health: curl http://127.0.0.1:3102/health
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
AGPL-3.0 — GoSiteMe Inc.
|
