aci

Rust implementation of "Mount APIs as CLIs".

aci mounts HTTP APIs as command-line interfaces in two ways:

• generic raw fetch mode (aci call ...)
• config-driven mount mode (aci --config aci.toml <mount> ...)

It also includes a coding-agent-oriented quick guide:

• aci skills

Install

cargo install --path .

Trusted Publishing

This repository is configured for crates.io trusted publishing.

Create and push a v<version> tag to trigger publish:

just release

or:

git tag v0.1.1
git push origin v0.1.1

Before first publish, enable trusted publishing for crate aci in crates.io and link f4ah6o/aci-rs.

Quick Start

0) Coding agent guide

aci skills

1) Generic API client mode

aci call --url https://api.github.com repos rust-lang rust \
  -H "Accept: application/vnd.github+json" \
  -H "User-Agent: aci"

2) Config-driven mode (aci.toml)

name = "aci"

[[mounts]]
name = "github"
kind = "remote"
base_url = "https://api.github.com"

aci --config aci.toml github repos rust-lang rust \
  -H "Accept: application/vnd.github+json" \
  -H "User-Agent: aci"

Raw Fetch Flags

• -X, --method <METHOD>
• -H, --header "Key: Value" (repeatable)
• -d, --data <json>
• --body <json>
• --query key=value (repeatable)
• unknown --key value is treated as query for compatibility

Auth / Token Example

aci call --url https://api.github.com user \
  -H "Accept: application/vnd.github+json" \
  -H "User-Agent: aci" \
  -H "Authorization: Bearer $GITHUB_TOKEN"

OpenAPI Mounts

Mount with OpenAPI by setting openapi in aci.toml:

name = "aci"

[[mounts]]
name = "pet"
kind = "remote"
base_url = "https://petstore3.swagger.io"
base_path = "/api/v3"
openapi = "./openapi.json"
timeout_ms = 10000

Behavior:

• operationId becomes command name
• missing operationId falls back to method_path name
• path params are positional args
• query/body params are --option value
• OpenAPI mounts always have raw subcommand fallback

Example:

aci --config aci.toml pet findPetsByStatus --status available
aci --config aci.toml pet raw pet findByStatus --query status=available

Exit Codes

• 0: success
• 1: upstream/API execution failure
• 2: usage/config/input error