freddie

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 install

Use

# 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