frago - Agent OS for AI agents: runtime, resource management, environment sync, and GUI for non-technical users
Project description
frago
Skeleton framework for AI Agents — Let AI remember how to complete tasks, instead of exploring from scratch every time.
Why frago
AI Agents are smart, but unpredictable. Ask the same task 10 times, you might get 10 different results — some work, some don't.
frago solves this with Recipe system: validated automation scripts that run deterministically. Once a Recipe works, it works every time.
Predictable execution. That's what matters.
Same philosophy as Anthropic's "Code execution with MCP": deterministic code beats repeated LLM exploration. frago uses Recipes instead of MCP.
Comparison
| Cowork | OpenClaw | frago | |
|---|---|---|---|
| Best for | Daily tasks | Cross-platform assistant | Reusable automation |
| Workflow | Chat → AI explores | Chat → AI explores | Explore → Agent auto-solidifies → Deterministic execution |
| Foundation | Claude Agent SDK | Custom | Claude Code |
Quick Start
uv tool install frago-cli # Install
frago init # Initialize
frago server start # Start Web UI → http://127.0.0.1:8093
New to
uv? See Installation Guide.
Requirements
| Dependency | Version |
|---|---|
| Python | 3.13+ |
| Node.js | 20+ |
| Chrome | Latest |
How It Works
frago integrates with Claude Code through slash commands:
/frago.run Explore and research, accumulate experience
↓
/frago.recipe Solidify experience into reusable recipes
↓
/frago.test Validate recipes (while context is fresh)
The Recipe Advantage
AI exploration: Unpredictable — might succeed, might fail, might take wrong path
↓
Once it works → save as Recipe
↓
Recipe execution: Deterministic — validated script, guaranteed results
Recipe = muscle memory. No thinking, just doing.
Core Systems
| System | Purpose |
|---|---|
| Recipe | Reusable automation scripts (chrome-js/python/shell) |
| Run | Persistent task context with JSONL logs |
| CDP | Native Chrome control (~2MB, no Node.js relay) |
| Web UI | Browser-based GUI on port 8093 |
CLI Commands
# Recipe management
frago recipe list # List all recipes
frago recipe run <name> # Execute recipe
# Browser control
frago chrome navigate <url>
frago chrome click <selector>
frago chrome screenshot <file>
# Server
frago server start/stop/status
Documentation
- Installation — Setup and prerequisites
- User Guide — Commands and usage
- Concepts — Run, Recipe, Skill relationships
- Architecture — Technical design
- Recipes — Recipe system deep dive
Resource Sync
Keep your recipes synced across machines:
frago sync --set-repo git@github.com:you/my-resources.git
frago sync # Bidirectional sync
License
AGPL-3.0 — See LICENSE
Contributing
Created with Claude Code
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file frago_cli-0.45.0.tar.gz.
File metadata
- Download URL: frago_cli-0.45.0.tar.gz
- Upload date:
- Size: 9.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
70416804f93a464c54627837f9c6ca8b140349760ba4e151706936be9704539c
|
|
| MD5 |
ba3fd377aec3144ad9a0370644bd835c
|
|
| BLAKE2b-256 |
bf5ca13a5361bb396d275846d13183f90974ef87536ab608f9301f30847327f8
|
File details
Details for the file frago_cli-0.45.0-py3-none-any.whl.
File metadata
- Download URL: frago_cli-0.45.0-py3-none-any.whl
- Upload date:
- Size: 2.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
98c2921ff43a6ff6830f26335cf3a223fddf376f475c070c19294becbb18716e
|
|
| MD5 |
6f52eaf8d97d58a21aa8ce32d6216226
|
|
| BLAKE2b-256 |
1275ab946d049ad6564c79be780943402dafacada57a4cb2945ea8a2ae7a37a1
|
