aci 0.1.2

Mount APIs as CLIs with raw HTTP and OpenAPI-backed commands
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

# 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

```bash
cargo install --path .
```

## Trusted Publishing

This repository is configured for [crates.io trusted publishing](https://crates.io/docs/trusted-publishing).

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

```bash
just release
```

or:

```bash
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

### Help

```bash
aci help
aci --help
```

### 0) Coding agent guide

```bash
aci skills
```

### 1) Generic API client mode

```bash
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`)

```toml
name = "aci"

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

```bash
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

```bash
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`:

```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:

```bash
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