https://github.com/rogerchappel/agentabi
Local-first CLI for snapshotting terminal coding-agent operational ABIs.
https://github.com/rogerchappel/agentabi
agentic-workflows cli developer-tools local-first
Last synced: about 1 month ago
JSON representation
Local-first CLI for snapshotting terminal coding-agent operational ABIs.
- Host: GitHub
- URL: https://github.com/rogerchappel/agentabi
- Owner: rogerchappel
- License: mit
- Created: 2026-05-27T22:16:18.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-04T03:37:21.000Z (about 1 month ago)
- Last Synced: 2026-06-04T05:21:47.268Z (about 1 month ago)
- Topics: agentic-workflows, cli, developer-tools, local-first
- Language: TypeScript
- Size: 41 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: ROADMAP.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# agentabi
Local-first CLI for snapshotting terminal coding-agent operational ABIs.
## Status
This repository is early-stage. Confirm the current support, release, and
security posture before using it in production.
## Install
From a checkout:
```sh
npm install
npm run build
npm link
```
## Use
Create a starter config:
```sh
agentabi init
```
Capture a deterministic local ABI snapshot:
```sh
agentabi capture --config agentabi.yaml --output agentabi.lock.json
```
Check the current machine against a committed lockfile:
```sh
agentabi check --config agentabi.yaml --lock agentabi.lock.json
```
Compare two snapshots:
```sh
agentabi diff baseline.json current.json --json
```
`check` exits non-zero when breaking changes are found.
## Config
```yaml
agents:
- id: codex
command: codex
version:
args: ["--version"]
help:
args: ["--help"]
requiredEnv:
- OPENAI_API_KEY
permissionFlags:
- "--sandbox"
toolCatalogs:
- id: mcp
path: tools.json
```
`agentabi` records only whether required environment variables are present, not
their values. Probes are restricted to safe `--version`, `-v`, `--help`, and
`-h` arguments.
## Automation Examples
Cron:
```cron
0 8 * * * cd /path/to/repo && agentabi check --config agentabi.yaml --lock agentabi.lock.json
```
Multi-agent runner preflight:
```sh
agentabi check --config agentabi.yaml --lock agentabi.lock.json
npm run agent-workflow
```
## Verify
Run the local validation script before opening a pull request:
```sh
bash scripts/validate.sh
```
`scripts/validate.sh` runs typecheck, tests, build, smoke, packaging checks, and
`agent-qc ready` when `agent-qc` is installed. Missing `agent-qc` is treated as
a skip, not a failure.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution expectations. Changes
should be small, reviewable, and verified before review.
## Security
See [SECURITY.md](SECURITY.md) for vulnerability reporting guidance.
## License
MIT