apexe 0.3.0

Outside-In CLI-to-Agent Bridge
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

# Basic Example: Scan Tools, Explore via Browser

Scans `ls` (instant result), `jq` (22 flags), and `curl` (12 flags), then starts an HTTP server with Explorer UI for browser-based testing.

## Prerequisites

- `apexe` installed (`cargo install --path ../..`)
- `ls`, `jq`, and `curl` on your `$PATH`

## Run

```bash
./run.sh
```

## What it does

1. Scans `ls`, `jq`, and `curl` (extracts flags and generates JSON Schema)
2. Writes binding files to `./output/modules/`
3. Prints Claude Desktop and Cursor integration configs
4. Starts HTTP server with Explorer UI at http://127.0.0.1:8000/explorer

## Using the Explorer UI

1. Open **http://127.0.0.1:8000/explorer** in your browser

2. Click **`cli.ls`** → type `{}` → click **Call**:
```json
{}
```
You'll see your current directory listing immediately. This is the quickest way to verify apexe works.

3. Click **`cli.curl`** → it has form fields for `data`, `verbose`, `silent`, etc. Try:
```json
{"verbose": true}
```

4. The response includes `stdout`, `stderr`, `exit_code`, `trace_id`, and `duration_ms`

## Claude Desktop integration

After testing with Explorer, switch to stdio for Claude Desktop:

```bash
apexe serve --show-config claude-desktop
```

Copy the JSON into `~/Library/Application Support/Claude/claude_desktop_config.json`, restart Claude Desktop.