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:

  1. 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.
  2. pipeline — the agent's tool surface narrows to a schema-checked put/get side-channel that your pre/post-processors mediate, over a token-protected loopback endpoint that exists only for the duration of one run.
  3. 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>

On interactive terminal invocations, agents-live checks PyPI for a newer stable release when its shared cached result is missing or one hour old. The result is stored under $XDG_CACHE_HOME/agents-live/ (normally ~/.cache/agents-live/). For ordinary commands, the refresh runs in the background and is skipped for scheduled/internal, quiet, JSON, piped, or redirected invocations. Network and cache failures never affect the command. This request sends only ordinary package-index request metadata; it does not include project or agent data. agents-live doctor is the exception: it always performs a fresh check and updates the cache. Checks never install updates in the background. Run agents-live upgrade to reinstall the uv-managed runtime at the latest stable release and then refresh managed skill payloads using the newly installed CLI.

Bare agents-live upgrade works outside a project and refreshes the current initialized project plus every available registered repository. An explicit --repo PATH|ALIAS limits payload refresh to that project. Use --runtime-only or --skills-only to run one half of the workflow. Unavailable registered repositories are reported without blocking other refreshes. init remains the first-time project setup command.

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

For work across projects, register normalized absolute repository paths in the user configuration ($XDG_CONFIG_HOME/agents-live/config.toml, normally ~/.config/agents-live/config.toml):

agents-live repos add ~/repos/<target-project>   # registered under its directory name
agents-live repos default ~/repos/<target-project>
agents-live --repo <target-project> status       # directory name also works
agents-live status --all-repos
agents-live doctor --all-repos
agents-live dashboard --all-repos   # read-only repository selector

Selection precedence is explicit --repo path or registered name, AGENTS_LIVE_REPO, the nearest local marker, markerless-git adoption for run/start, then the configured default. A default never overrides the current project. Aggregate commands are read-only; lifecycle mutations always target one selected repository, and persisted commands pin its absolute path.

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: claude or copilot

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.

Project links

Data verified by PyPI on Jul 19, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (6.9.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for johnshew from gravatar.com johnshew

GitHub Statistics

Data verified by PyPI on Jul 19, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

Requires

Python >=3.12

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agents_live-0.3.1.tar.gz (256.3 kB view details)

Uploaded Source

Built Distribution

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

agents_live-0.3.1-py3-none-any.whl (249.7 kB view details)

Uploaded Python 3

File details

Details for the file agents_live-0.3.1.tar.gz.

File metadata

  • Download URL: agents_live-0.3.1.tar.gz
  • Upload date:
  • Size: 256.3 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

Hashes for agents_live-0.3.1.tar.gz
Algorithm Hash digest
SHA256 81116781c39d03f7bf0dd42b59f15aa4e47eede87edceffe145361381e437b5f
MD5 2b6050d3dc08f403393606373d703a21
BLAKE2b-256 270e6ae86ec432f025e6125434a39cd550e0f24ae6113f88e733c880f3dfa438

See more details on using hashes here.

File details

Details for the file agents_live-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: agents_live-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 249.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

Hashes for agents_live-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c1cdc91aed24caab9cc66317b4afa523ca4d8e0e65d6b14e08c2830230717570
MD5 2e61b54d979e9c1f5f9af58e2edd53c1
BLAKE2b-256 85978ca878fa7a0596d12b43d4af8c26419733b00b903ac1bcbdbff2136bc64d

See more details on using hashes here.

Release history Release notifications | RSS feed

6.9.1

2 files

6.9.0

2 files

6.8.0

2 files

6.7.0

2 files

6.6.0

2 files

6.5.0

2 files

6.4.1

2 files

6.3.8

2 files

6.3.5

2 files

6.3.4

2 files

6.3.3

2 files

6.3.2

2 files

6.3.1

2 files

6.3.0

2 files

6.2.0

2 files

6.1.1

2 files

6.1.0

2 files

6.0.6

2 files

6.0.5

2 files

6.0.4

2 files

6.0.3

2 files

6.0.2

2 files

6.0.1

2 files

6.0.0

2 files

5.5.2

2 files

5.5.1

2 files

5.5.0

2 files

5.4.2

2 files

5.4.1

2 files

5.4.0

2 files

5.3.0

2 files

5.2.0

2 files

5.1.0

2 files

5.0.1

2 files

5.0.0

2 files

4.0.0

2 files

3.0.0

2 files

2.2.0

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

1.0.0

2 files

This release

0.3.1 This release

2 files

0.3.0

2 files

0.2.0

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page