@fancyrobot/fred-dev

Development-only tooling package for the Fred monorepo.

Scope

@fancyrobot/fred-dev is for local development workflows (contributors and maintainers). It provides helper entrypoints like dev chat and a thin local server command bridge used while building Fred.

Reusable HTTP server APIs now live in @fancyrobot/fred-http. This package is not intended as a production runtime dependency for application deployments.

Prerequisites

Bun installed
A configured provider API key when using chat/server flows (for example OPENAI_API_KEY)

Intended Use

Use this package when you are contributing to Fred or running local project tooling.

Avoid using this package as a runtime dependency in shipped applications.

Usage

From the repository root:

# Run local development chat
bun run dev

# Run local development server
bun run server

You can also run package scripts directly:

bun run --filter @fancyrobot/fred-dev dev
bun run --filter @fancyrobot/fred-dev server

Server Mode

Start the development server bridge:

bun run server
# Or with options:
bun run server --config config.yaml --port 3000

The underlying @fancyrobot/fred-http server exposes an OpenAI-compatible API:

Endpoint	Description
`POST /v1/chat/completions`	OpenAI-compatible chat (works with Chatbox, etc.)
`POST /chat`	Simplified chat endpoint
`POST /message`	Process with intent matching options
`GET /agents`	List agents
`GET /intents`	List intents
`GET /tools`	List tools
`GET /health`	Health check

What It Exports

startDevChat from src/dev-chat.ts
chat default/provider helpers from src/chat-defaults.ts

For reusable HTTP APIs, import from @fancyrobot/fred-http instead.

Stability

This package follows Fred's release process, but its API is primarily optimized for repository development workflows and may change as contributor tooling evolves.

License

MIT