agent-devex

devex

Agent-operated developer-experience CLI. Non-agentic, deterministic, markdown-first. The same wheel is published on PyPI under three distribution names — devex-cli (canonical), agent-devex, and agex-cli (the legacy canonical name, still published) — and installs two equivalent commands, devex (canonical) and agex (legacy alias) (emitted output reflects whichever name you invoke).

Install

uv tool install devex-cli      # or: agex-cli
# or
pipx install devex-cli         # or: pipx install agex-cli

Quick start

devex explain devex
devex overview --agent claude-code
devex learn --agent claude-code
devex advise --agent claude-code

The advice loop

devex advise --agent <backend> closes the developer-experience loop: it measures three coverage surfaces (usage, test, capability), learns from the agent's own tracked usage, renders an introspection trail, and ends with a recommended next move. Its per-backend Next step: footer chains command to command so an agent can run non-touch. Read-only and deterministic — zero LLM calls. Usage tracking arrives via devex gamify hooks. See docs/advise-loop.md for a full walkthrough with real output.

PR webhooks (opt-in)

Set DEVEX_PR_WEBHOOK_URL and devex pr open / pr reply / pr review will POST a best-effort JSON notification ({event, repo, id, subject, content}) to that webhook. Discord URLs are auto-detected and get a Discord-shaped payload; any other URL gets the raw fields. Unset = no network call; a failed POST never blocks the PR action. See devex explain pr for details.

Docs

culture.dev/devex.

Spec: docs/superpowers/specs/2026-04-18-agex-design.md.

License

MIT.