# agentctl

> agentctl is the open-source, local-first control plane for agent engineering environments, developed by justREPL.

- [Canonical site](https://agentctl.justrepl.com/)
- [Source repository](https://github.com/lstan44/agentctl)
- License: Apache-2.0

## Current release

v0.2 initializes a Git-backed canonical root at `~/.agentctl`, inventories existing agent configuration, and safely plans and manages installation, updates, and configuration-preserving uninstall for Codex, Claude Code, OpenCode, Gemini CLI, GitHub Copilot CLI, OpenClaw, and Hermes Agent. It also manages its own verified update and canonical-root-preserving uninstall.

`inspect` and `doctor` never execute target tools or write configuration. `agents status` invokes only documented version queries. Lifecycle mutations expose exact static plans, require `--yes`, preserve agent-owned configuration, and record success only after verification.

## Documentation

- [Getting started](https://agentctl.justrepl.com/docs/)
- [Security model](https://agentctl.justrepl.com/security/)
- [Installer source](https://agentctl.justrepl.com/install.sh)
- [Tool lifecycle contract](https://github.com/lstan44/agentctl/blob/main/docs/tool-lifecycle.md)
- [JSON schemas](https://github.com/lstan44/agentctl/tree/main/spec/schemas)

## Install

```sh
curl -fsSL https://agentctl.justrepl.com/install.sh | bash
```

Then initialize and inspect:

```sh
agentctl init
agentctl agents status
agentctl inspect
agentctl self update --dry-run
```