agents-live
Take your agents live. agents-live adds safe, local automation to the Claude Code and GitHub Copilot agents you already use — cron and file-watch dispatch, deterministic pre/post processing, safety wrappers, and operations. It does not replace your agents: an agent stays one Markdown file with the same prompt. A few frontmatter fields say when it runs (a cron schedule, a watched directory, or both) and how (the agent CLI, execution mode, optional pre/post scripts):
---
runtime: claude # unattended execution adapter
mode: plan # read-only; a handler script does the writing
watchPath: notes/inbox/ # or schedule: "0 8 * * *", or both
post-processor: file-notes.sh
---
For each new file in notes/inbox/: add frontmatter and tags, fix the
title, decide where it belongs in the vault, and emit JSON:
{ "moves": [{ "from": "...", "to": "...", "content": "..." }] }
Drop a raw note into notes/inbox/ and the watcher fires within
seconds; one agent run later the note is cleaned up and filed. The
agent thinks, a script acts: the agent decides, but the only thing
that touches your files is a deterministic handler you own.
Safe by default
Write access is a ladder with an explicit final rung:
- plan (the default) — the agent runs read-only and emits JSON; a runner validates it (JSON Schema, size caps, path roots, provenance) and hands it to your deterministic handler.
- pipeline — the agent's tool surface narrows to a schema-checked
put/getside-channel that your pre/post-processors mediate, over a token-protected loopback endpoint that exists only for the duration of one run. - write — full write access: the last option, an explicit per-agent opt-in.
This ladder is tool policy, not a sandbox — agents inherit your local account's privileges unless you configure stricter CLI or OS isolation.
Lightweight
No framework to learn, no APIs to call, no daemon to maintain — just things you use every day: git, files, markdown, cron, and scripts. Cron and inotifywait do the triggering; agents-live adds activation, debounce, concurrency, structured logs, and per-run token cost. If you can read a crontab, you can audit the whole system. No application daemons or gateways, no externally reachable inbound ports, no databases (plain-text JSONL logs, aged into monthly Parquet archives). The only persistent processes are one small watcher loop per file-watch agent; cron-only agents need none.
Install
uv tool install agents-live # or: uv tool install <path-to-wheel>
Check for and install a newer PyPI release with uv tool upgrade agents-live. After upgrading, run agents-live --repo <project> init to
refresh the optional installed skill payload; doctor reports a package and
payload version mismatch.
Quick start
cd your-repo
agents-live doctor # verify cron, inotifywait, and agent CLIs
agents-live init # layout + config marker + skill payload
# copy a starter from .claude/skills/agents-live/templates/ into Agents/
agents-live run my-agent # test once, in the foreground
agents-live start my-agent # activate cron/watcher triggers
agents-live status
agents-live logs
agents-live teardown my-agent # deactivate — remove its triggers
Requirements
- Python 3.12+ and uv
crontab(scheduled agents),inotifywait(file watchers; preflight is trigger-derived, so cron-only setups don't need inotify)- An agent CLI for agent-backed definitions:
claudeorcopilot
Linux-first: Ubuntu on WSL is the reference platform, Windows support
is partial, and macOS is untested. agents-live doctor reports
exactly what this host is missing.
Documentation
The /agents-live skill is optional conversational support for the
CLI: agents-live init installs it for Claude Code, every flow it
drives is an ordinary agents-live command, and the CLI is fully
usable without it.
- Overview
- Architecture
- Commands
- Starter templates
- SKILL.md — full reference
1 maintainer
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 agents_live-0.1.5.tar.gz.
File metadata
- Download URL: agents_live-0.1.5.tar.gz
- Upload date:
- Size: 211.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7a5a6641a66c68fe452a23dd23fcc8511e2b86bdd4f7d7f3ca1a4b32cb9fd606
|
|
| MD5 |
3e681b47162ee02d1a854a2d9a460c8e
|
|
| BLAKE2b-256 |
87285d52a32092ce208ce7c4902ed8d18533474f75827ee6fa3080289cf81673
|
File details
Details for the file agents_live-0.1.5-py3-none-any.whl.
File metadata
- Download URL: agents_live-0.1.5-py3-none-any.whl
- Upload date:
- Size: 221.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fd7ad52c1ad0cb70aa403d3d5a4d57df86a2e65bc30f95b031946e591d2a219f
|
|
| MD5 |
c2668e848ac8da7405af18a20c40b5c8
|
|
| BLAKE2b-256 |
89214829b6efbd843181f1c8231c6c6367002e40cd07b049883fc885c32bc877
|
