https://github.com/mizcausevic-dev/aeo-cli
Command-line tool for the AEO Protocol v0.1. Validate, fetch, inspect, and extract claims from AEO declaration documents. Built on aeo-sdk-rust. clap + ureq + colored. Cargo-installable.
https://github.com/mizcausevic-dev/aeo-cli
aeo aeo-protocol answer-engine-optimization clap cli command-line kinetic-gain-protocol-suite protocol-implementation rust validator
Last synced: 12 days ago
JSON representation
Command-line tool for the AEO Protocol v0.1. Validate, fetch, inspect, and extract claims from AEO declaration documents. Built on aeo-sdk-rust. clap + ureq + colored. Cargo-installable.
- Host: GitHub
- URL: https://github.com/mizcausevic-dev/aeo-cli
- Owner: mizcausevic-dev
- License: agpl-3.0
- Created: 2026-05-12T05:18:24.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-23T21:41:04.000Z (20 days ago)
- Last Synced: 2026-05-23T23:22:02.428Z (20 days ago)
- Topics: aeo, aeo-protocol, answer-engine-optimization, clap, cli, command-line, kinetic-gain-protocol-suite, protocol-implementation, rust, validator
- Language: Rust
- Homepage: https://github.com/mizcausevic-dev/aeo-cli
- Size: 31.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# aeo-cli
Command-line tool for the [AEO Protocol v0.1](https://github.com/mizcausevic-dev/aeo-protocol-spec). Validate, fetch, inspect, and extract claims from AEO declaration documents.
Built on top of [aeo-sdk-rust](https://github.com/mizcausevic-dev/aeo-sdk-rust).
## Install
```bash
cargo install --git https://github.com/mizcausevic-dev/aeo-cli
```
This installs an `aeo` binary on your `PATH`.
## Usage
```
aeo --help
Validate, fetch, and inspect AEO Protocol declaration documents.
Spec: https://github.com/mizcausevic-dev/aeo-protocol-spec
Usage: aeo
Commands:
validate Validate a local AEO document file against the v0.1 schema
fetch Fetch and pretty-print the AEO declaration at an origin's well-known URL
inspect Show a structured summary of an AEO document
claim Extract and print a specific claim by ID
help Print this message or the help of the given subcommand
```
## Examples
**Validate a local file:**
```bash
aeo validate ./aeo.json
# OK ./aeo.json — Miz Causevic (6 claims)
```
**Fetch a live declaration:**
```bash
aeo fetch https://mizcausevic-dev.github.io
# {
# "aeo_version": "0.1",
# "entity": { "name": "Miz Causevic", ... },
# ...
# }
```
**Inspect (works on either a path or a URL):**
```bash
aeo inspect https://mizcausevic-dev.github.io
# Protocol: 0.1
# Entity: Person
# Name: Miz Causevic
# ID: https://mizcausevic-dev.github.io/#person
# Canonical URL: https://mizcausevic-dev.github.io/
# Primary sources: 4
# Verifications: 3
# Claims: 6
# - current-role jobTitle High
# - location address High
# - years-experience aeo:yearsOfExperience High
# - live-products aeo:operates High
# - primary-stack aeo:primaryLanguageStack High
# - authored-spec aeo:authoredSpecification High
# Audit mode: none
```
**Extract a specific claim:**
```bash
aeo claim https://mizcausevic-dev.github.io years-experience
# {
# "id": "years-experience",
# "predicate": "aeo:yearsOfExperience",
# "value": 30,
# "confidence": "high"
# }
```
## Conformance
Supports AEO Protocol v0.1 at **conformance Level 1 (Declare)**. Signature verification (L2) and audit-endpoint reporting (L3) deferred to v0.2.
## Exit codes
| Code | Meaning |
|---|---|
| `0` | Success |
| `1` | Error (parse failure, network failure, missing claim, etc.) |
## Development
```bash
cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo build --release
cargo test
```
Integration tests build the binary and invoke it as a subprocess; tests cover validate (happy + malformed), inspect, claim (found + missing).
## Specification
Full spec at [github.com/mizcausevic-dev/aeo-protocol-spec](https://github.com/mizcausevic-dev/aeo-protocol-spec).
## License
AGPL-3.0.
## Kinetic Gain Protocol Suite
| Spec | Implementation |
|---|---|
| [AEO Protocol](https://github.com/mizcausevic-dev/aeo-protocol-spec) | [aeo-sdk-python](https://github.com/mizcausevic-dev/aeo-sdk-python) · [aeo-sdk-typescript](https://github.com/mizcausevic-dev/aeo-sdk-typescript) · [aeo-sdk-rust](https://github.com/mizcausevic-dev/aeo-sdk-rust) · [aeo-sdk-go](https://github.com/mizcausevic-dev/aeo-sdk-go) · **aeo-cli** (this) · [aeo-crawler](https://github.com/mizcausevic-dev/aeo-crawler) |
| [Prompt Provenance](https://github.com/mizcausevic-dev/prompt-provenance-spec) | — |
| [Agent Cards](https://github.com/mizcausevic-dev/agent-cards-spec) | — |
| [AI Evidence Format](https://github.com/mizcausevic-dev/ai-evidence-format-spec) | — |
| [MCP Tool Cards](https://github.com/mizcausevic-dev/mcp-tool-card-spec) | — |
---
**Connect:** [LinkedIn](https://www.linkedin.com/in/mirzacausevic/) · [Kinetic Gain](https://kineticgain.com) · [Medium](https://medium.com/@mizcausevic/) · [Skills](https://mizcausevic.com/skills/)