agents-live

Take your agents live. Turn Claude Code and GitHub Copilot agents into scheduled and file-triggered local automations, without moving them to another agent platform.

Your agent stays one Markdown file. Agents Live adds triggers, execution controls, logs, and automatic repair using standard host tools.

markdown-polisher.md

---
description: Polish Markdown documents when they change.
runtime: claude
mode: write
watchPath: docs/
---
Correct spelling, grammar, and Markdown formatting errors in the selected files.
Preserve their meaning, links, code, and frontmatter. When a `Files changed:`
list is present, process only those files.

Quick start

See Prerequisites for required host tools and installation details.

uv tool install agents-live
agents-live init
agents-live start ./markdown-polisher.md

The watcher sleeps until a file changes, then runs the agent immediately with the changed paths. Add or edit a Markdown file under docs/, then open the file to see the fixes.

Manage the running agent with status and stop:

agents-live status
agents-live stop ./markdown-polisher.md

There is no polling interval or clock tick. The agent runs only when the operating system reports a change in the watched directory.

Lightweight

There is no listener service, separate application runtime, or database to deploy and maintain. The core stack is the Claude Code or GitHub Copilot CLI you already use, uv, crontab for scheduling and maintenance, and inotifywait for file watches.

Cron-only agents have no persistent process. A file-watch agent uses one small local watcher. There are no externally reachable ports or databases. Custom handlers and plugins may bring their own dependencies; Agents Live core does not require them.

Safe by default

Execution modes make write access explicit:

  1. plan is read-only. The agent emits JSON for a validated handler to apply.
  2. pipeline limits the agent to a schema-checked data channel shared with your pre-processors and post-processors.
  3. write grants full write access as an explicit per-agent choice.

This is tool policy, not a sandbox. Agents still inherit the permissions of your local account and agent CLI.

The example uses write so it can fix documents directly. For tighter control, use plan with a validated handler or pipeline with schema-checked pre-processors and post-processors.

Prerequisites

  • uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Claude Code: npm i -g @anthropic-ai/claude-code
  • GitHub Copilot CLI: npm i -g @github/copilot
  • crontab and inotifywait: sudo apt install cron inotify-tools

Install Claude Code, GitHub Copilot CLI, or both. crontab supports initialization, automatic maintenance, and scheduled agents; inotifywait is only required when agents watch files or directories for changes.

Linux is the primary platform, with Ubuntu on WSL as the reference setup. Windows support is partial and macOS is untested.

Run agents-live doctor to diagnose missing requirements and inspect configuration. Use agents-live doctor --repair to repair supported configuration issues.

Go further

Repositories are optional. Initialize one later with agents-live init --repo when you need shared configuration or name-based commands.

See the command reference for repository workflows, health checks and repair, upgrades, dashboards, shell completion, plugins, ownership, and multi-repository operations. The architecture guide covers runtime, safety, persistence, and maintenance behavior.

Documentation

The optional /agents-live skill is installed by agents-live init, but every workflow remains an ordinary CLI command.

Project links

Data verified by PyPI on Jul 22, 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 22, 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-3.0.0.tar.gz (323.5 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-3.0.0-py3-none-any.whl (295.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agents_live-3.0.0.tar.gz
  • Upload date:
  • Size: 323.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.31 {"installer":{"name":"uv","version":"0.11.31","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-3.0.0.tar.gz
Algorithm Hash digest
SHA256 4173c002b98f4f0dbca19a15243e293c7479bcf7bcfef2ea657775ca28051c07
MD5 5eca3ba22cd18a2b06fd0301956191c1
BLAKE2b-256 671029820b3df0e2941a37a22b71d9de90e59ab15288008f5945dd6f9e75e1ac

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agents_live-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 295.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.31 {"installer":{"name":"uv","version":"0.11.31","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-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3813ec4d1c5f9ba8582667465f6395b93d6ef100d6aac75be2f71f458655559c
MD5 e4284aa326b3cb02217c9ed817faec45
BLAKE2b-256 53610b2e1d3c4033cfd544e493bc583c159aea87fbb13ca68fedc581e5bc1177

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

This release

3.0.0 This release

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

0.3.1

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