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.3.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.3-py3-none-any.whl (2.6 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: frago_cli-0.44.3.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.3.tar.gz
Algorithm Hash digest
SHA256 5b276f598f333ea1b5e5059b8ead4c3b600e336e2e5b6608384c3b164343b85a
MD5 323cc76b28ed9ebaecae505c70cffba5
BLAKE2b-256 9cfc58a4dab182dacedd516712ea65791295aa34a2bdb99020e16f64960ecf59

See more details on using hashes here.

File details

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

File metadata

  • Download URL: frago_cli-0.44.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 50898ba2b460d2bdccdf6577019c98f3969c2bc6e6e971a05965f496315e54d1
MD5 a36de396774ec62cce272bac61d3a6b8
BLAKE2b-256 027978dcf1415d8dac30158543c6873a9b656d2f66624840adc5aa1d71b1016d

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