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

Uploaded Python 3

File details

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

File metadata

  • Download URL: frago_cli-0.44.4.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.4.tar.gz
Algorithm Hash digest
SHA256 5cf7b9e5a82530e24cbcacfd12b992e508bc3731c8c089d668949018b173f400
MD5 39d7dc02d93650b60894aa4a18bd5b6c
BLAKE2b-256 e4695465b979ae6ac06febecfbddec1e241f7574fb162b0a00d5c3404bf50176

See more details on using hashes here.

File details

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

File metadata

  • Download URL: frago_cli-0.44.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 52e2a13867e5ba6ccc763f74fe293d2d182b0b0682809e94911e5406859c36bb
MD5 7c535f80f15a1f94f17a62ac5ff0c175
BLAKE2b-256 43c733d8d8ac1ba7727f275cdc4fea70fba54bf6ad36227662274df3975cac72

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