Freddie
An open JS agent harness built on pi-mono, xstate, floosie, and anentrypoint-design. Features a full gateway, context compressor, multi-platform adapters, and a live dashboard — built with:
- @mariozechner/pi-coding-agent — agent + tools + interactive TUI substrate
- @mariozechner/pi-agent-core — agent loop primitives
- @earendil-works/pi-ai — provider abstraction (Anthropic / OpenAI / Groq / …)
- @earendil-works/pi-tui — TUI primitives
- floosie — gateway stream pipeline (xstate-backed)
- xstate — agent turn machine + lifecycle state machines
- anentrypoint-design — webjsx + ripple-ui design system (replaces React for the dashboard)
- flatspace — flat-file CMS + static site builder (powers the website/ documentation site)
See AGENTS.md for the full subsystem guide and residual complement.
Install
cd c:/dev/freddie
npm installUse
# List tools (>=11 registered)
node bin/freddie.js tools
# All slash-style commands
node bin/freddie.js help-all
# Interactive REPL (skin-aware, slash commands routed via registry)
node bin/freddie.js run
# Run a single prompt non-interactively (exits after response)
node bin/freddie.js exec --prompt "list 3 penguin species"
node bin/freddie.js profile list node bin/freddie.js profile create coder node bin/freddie.js profile switch coder
Skin engine (default | ares | mono | slate)
node bin/freddie.js skin node bin/freddie.js skin ares
Sessions and search
node bin/freddie.js sessions node bin/freddie.js search "<query"
Cron scheduler (persistent jobs in SQLite)
node bin/freddie.js cron list node bin/freddie.js cron add "/5 " "summarize my email" node bin/freddie.js cron tick
Batch runner (parallel runs, JSONL output)
node bin/freddie.js batch prompts.txt --concurrency 4