Open source · MIT · macOS / Linux / Windows
Your machine.
Your agent. Your story.
onfable is an open-source autonomous AI agent that lives in your terminal — it runs commands, edits files, browses the web, and remembers you. Bring any model: Claude, OpenAI, OpenRouter, or your own endpoint.
$ curl -fsSL https://onfable.xyz/install.sh | shSee it in action
One sentence in. Real work out — with your approval on every command.
Installed in one line
Node.js 20+ is the only prerequisite. Your API key stays on your machine.
$ curl -fsSL https://onfable.xyz/install.sh | shThen run onfable setup — pick a provider, paste your key, done.
An agent, not a chatbot
Chatbots tell you how. onfable just does it.
Runs 100% locally
onfable lives on your machine — macOS, Linux, or Windows. Your API key, your files, your data: everything stays in ~/.onfable, nothing passes through our servers.
Works with any model
Claude by default — up to Claude Fable 5, the most powerful model you can run (and yes, the name is fate). Or OpenAI, OpenRouter, and any OpenAI-compatible endpoint. Switch with one command.
Persistent memory
It remembers you. Preferences, project context, how you like things done — saved to a plain markdown file you can read and edit yourself.
Power with guardrails
Full system access — shell, files, the lot — but every command and file write asks for your approval first. Trust it? Run with --yolo.
Web-aware
Built-in web search and page fetching. It can look things up, read documentation, and pull real data into your tasks — no extra API key needed.
MCP servers, incl. Base
Connect Model Context Protocol servers and the agent gains their tools. Ships with Base — onchain wallet, USDC transfers, swaps, and DeFi — via a browser-authorized agentic wallet. No private keys in onfable.
Open source & hackable
MIT licensed, one lean TypeScript codebase. Add a tool in ~40 lines. Read every prompt it sends. Fork it and make it yours.
Up and running in a minute
Install
One line in your terminal. macOS, Linux, or Windows.
curl -fsSL onfable.xyz/install.sh | shSetup
Pick your provider, paste your API key. Saved locally, chmod 600.
onfable setupAsk anything
It plans, runs the tools, and reports back — approving with you along the way.
onfable run "clean up my git branches"Meet it where you are
The terminal is home base. Messaging channels are on the roadmap.
Interactive REPL + one-shot runs
Your agent in your pocket
Agent for your server
Roadmap
Built in the open — order follows demand. Vote with an issue.
The agent
- ✓CLI agent: shell, files, web search/fetch, persistent memory
- ✓Any model: Claude (incl. Fable 5), OpenAI, OpenRouter, Bankr, local
- ✓One-line installers for macOS, Linux, Windows
- ✓MCP support with Base built in — wallet, USDC, swaps, DeFi
- ✓$ONFABLE launched on Virtuals Protocol (Base)
Community & reach
- ·Contributor bounty program paid in $ONFABLE
- ·Telegram channel adapter — your agent in your pocket
- ·Markdown rendering in the terminal
- ·Growing the MCP server registry
Autonomy
- ·Scheduled tasks — "every morning, summarize my inbox"
- ·Subagents for parallel work
- ·Discord adapter
- ·$ONFABLE roadmap governance (token-weighted voting)
Hosted onfable
- ·Cloud agents that run while your machine sleeps
- ·Cross-device memory sync
- ·Sandboxed execution backends
- ·Hosted features gated & paid with $ONFABLE
$ONFABLE
The onfable ecosystem token — utility first, on the network the agent already speaks.
0xeC76Ee25C41B51927b24b173622547A8dC89dc5DAlways verify the contract address — this is the only official $ONFABLE.
Native to the agent
onfable ships with Base MCP built in — your agent can check, hold, and transfer $ONFABLE (and any Base token) out of the box. The token lives where the product lives.
The agent's onchain identity
$ONFABLE is onfable's agent token on Virtuals Protocol — the onchain handle for the project's agent economy on Base.
Contributor bounties
Open-source contributions paid in $ONFABLE, starting with the good-first-issue board. Ship code, earn the token.
Roadmap governance
Token-weighted voting on what gets built next — channel adapters, MCP servers, hosted features.
Access to hosted onfable
When cloud features ship (scheduled tasks, hosted agents, memory sync), $ONFABLE gates and pays for them.
$ONFABLE is a utility token for the onfable ecosystem. Nothing on this page is financial advice or a solicitation to invest; digital assets are volatile and carry risk. The onfable software is and will remain free and open source — no token is required to use it.
Questions, answered
Is it free?+
Yes — onfable is MIT-licensed open source and free forever. You only pay your AI provider for the tokens you use (bring your own API key).
Which models can I use?+
Anthropic Claude — including Claude Fable 5, the strongest model available (a fable running onfable: the name wrote itself). Also OpenAI, anything on OpenRouter, the Bankr LLM Gateway, or any OpenAI-compatible endpoint, including local servers like Ollama or LM Studio. Switch anytime with `onfable setup`. onfable is an independent open-source project — bring your own API key.
Is it safe to let an AI run commands on my machine?+
onfable is built around approval-first execution: every shell command, file write, and file edit shows you exactly what it wants to do and waits for your yes. Reads don't need approval. When you trust a workflow, `--yolo` skips the prompts.
Where is my data stored?+
Only on your machine. Your config (API key, chmod 600), memory, and session history live in ~/.onfable/. Conversations go directly from your machine to your chosen AI provider — there is no onfable server in between.
What is $ONFABLE?+
The onfable ecosystem token on Base, launched via Virtuals Protocol (contract 0xeC76…dc5D — always verify). Today it's native to the agent itself (onfable's built-in Base MCP can hold and transfer it) and funds contributor bounties; token-weighted roadmap voting and access to future hosted features are planned. The software stays free and open source — no token is required to use onfable. Not financial advice.
Can it do onchain / crypto actions?+
Yes — onfable supports Model Context Protocol (MCP) servers, and ships with Base. Run `onfable mcp add base`, authorize an agentic wallet in your browser (with spending limits, no private keys handed to onfable), and the agent can check balances, send USDC, swap, and use DeFi on Base. Every onchain action still asks for your approval first.
How is this different from a chatbot?+
A chatbot tells you the commands to run. onfable runs them — it lists your files, edits them, searches the web, retries when something fails, and remembers your preferences for next time. It's an agent with hands, not just a voice.