Skip to main content

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

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

Project details


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

frago_cli-0.44.5.tar.gz (9.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

frago_cli-0.44.5-py3-none-any.whl (2.6 MB view details)

Uploaded Python 3

File details

Details for the file frago_cli-0.44.5.tar.gz.

File metadata

  • Download URL: frago_cli-0.44.5.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":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for frago_cli-0.44.5.tar.gz
Algorithm Hash digest
SHA256 5992d19d7d2011ad3e49771e41a0a18c32f605d5493a7e870af7cbc3a7a03aaa
MD5 f516bc09e8ac152302c8536ebf2373b2
BLAKE2b-256 c20421441e2843316dfc5890219ac4ef7b559b97eb80ad7a5e2b30e9370e55fd

See more details on using hashes here.

File details

Details for the file frago_cli-0.44.5-py3-none-any.whl.

File metadata

  • Download URL: frago_cli-0.44.5-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":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for frago_cli-0.44.5-py3-none-any.whl
Algorithm Hash digest
SHA256 1ed413bd93f2abfd29a2313d968ae85e1f551149343d78df8ebd3389696b00c1
MD5 22543b265cb7ca1cff82a83a481c67b1
BLAKE2b-256 6fc308c7bddc3005ac16456dfb000a232d07a3a155a604610b1b267497920ebc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page