Skip to content

Commit f3bce19

Browse files
committed
Add commands
1 parent ff4f676 commit f3bce19

11 files changed

Lines changed: 946 additions & 0 deletions

File tree

assets/commands/aimock.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
# TAGLINE
2+
3+
Mock infrastructure for AI application testing
4+
5+
# TLDR
6+
7+
**Start** a mock server with fixtures
8+
9+
```npx aimock -p [4010] -f [./fixtures]```
10+
11+
**Start** from a configuration file
12+
13+
```npx aimock --config [aimock.json]```
14+
15+
**Record** real API responses as fixtures
16+
17+
```npx aimock --record --provider-openai [https://api.openai.com]```
18+
19+
**Convert** fixtures from another tool
20+
21+
```npx aimock convert [vidaimock] [./templates/] [./fixtures/]```
22+
23+
**Run** with Docker
24+
25+
```docker run -d -p 4010:4010 -v [./fixtures]:/fixtures ghcr.io/copilotkit/aimock -f /fixtures```
26+
27+
# SYNOPSIS
28+
29+
**npx aimock** [_options_]
30+
31+
**npx aimock convert** _format_ _source_ _destination_
32+
33+
# PARAMETERS
34+
35+
**-p, --port** _number_
36+
> Port to listen on (default: 4010)
37+
38+
**-f, --fixtures** _directory_
39+
> Path to the fixtures directory
40+
41+
**--config** _file_
42+
> Load configuration from a JSON file
43+
44+
**--record**
45+
> Enable record mode to proxy real APIs and save responses as fixtures
46+
47+
**--provider-openai** _url_
48+
> OpenAI provider URL for proxying in record mode
49+
50+
**convert** _format_ _source_ _dest_
51+
> Convert fixtures from other tools (vidaimock, mockllm)
52+
53+
# DESCRIPTION
54+
55+
**aimock** is deterministic mock infrastructure for testing AI applications. It mocks LLM APIs, image generation, text-to-speech, transcription, video generation, MCP tools, A2A agents, AG-UI event streams, vector databases, search, rerank, and moderation — all from one package on one port with zero dependencies.
56+
57+
The tool supports **11 LLM providers** including OpenAI, Claude, Gemini, Bedrock, Azure, Vertex AI, Ollama, and Cohere with full streaming support. **Record & Replay** mode proxies real APIs and saves responses as fixtures for deterministic test playback. Chaos testing capabilities allow simulating failures and edge cases.
58+
59+
aimock runs daily against real provider APIs and catches response format changes within 24 hours, maintaining fixture compatibility. It is built entirely on Node.js builtins with no external dependencies.
60+
61+
# CAVEATS
62+
63+
Intended for **testing environments only**, not production deployment. Requires **Node.js** for npx usage or Docker for containerized deployment. Record mode requires valid API keys for the providers being recorded. Fixture format is specific to aimock and may need conversion from other mocking tools.
64+
65+
# HISTORY
66+
67+
aimock was created by the **CopilotKit** team and written in **TypeScript**. It was developed to address the challenge of testing AI applications that may touch multiple external services in a single request — LLMs, tool servers, vector databases, rerankers, and moderation layers — providing a single mock server that covers the entire agentic stack.
68+
69+
# SEE ALSO
70+
71+
[node](/man/node)(1), [npx](/man/npx)(1), [docker](/man/docker)(1)

assets/commands/appclipcodegen.md

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# TAGLINE
2+
3+
Generate and validate Apple App Clip Codes
4+
5+
# TLDR
6+
7+
**Generate** an App Clip Code as SVG
8+
9+
```AppClipCodeGenerator generate --url [https://example.com] --type [cam] --foreground [FFFFFF] --background [000000] --output [output.svg]```
10+
11+
**Generate** an NFC-enabled App Clip Code
12+
13+
```AppClipCodeGenerator generate --url [https://example.com] --type [nfc] --foreground [FFFFFF] --background [000000] --output [output.svg]```
14+
15+
**Validate colors** and get suggestions
16+
17+
```AppClipCodeGenerator suggest --foreground [FFFFFF] --background [000000]```
18+
19+
# SYNOPSIS
20+
21+
**AppClipCodeGenerator** \<command\> [_options_]
22+
23+
# PARAMETERS
24+
25+
**generate**
26+
> Generate an App Clip Code SVG file
27+
28+
**suggest**
29+
> Validate color combinations and get suggestions
30+
31+
**--url** _URL_
32+
> The URL that opens when the App Clip Code is scanned
33+
34+
**--type** _cam|nfc_
35+
> Code type: **cam** for camera-only scanning or **nfc** for NFC-enabled codes
36+
37+
**--foreground** _RRGGBB_
38+
> Foreground color as a hex value
39+
40+
**--background** _RRGGBB_
41+
> Background color as a hex value
42+
43+
**--output** _path_
44+
> Output path for the generated SVG file
45+
46+
# DESCRIPTION
47+
48+
**AppClipCodeGenerator** is Apple's official command-line tool for creating and validating App Clip Codes. App Clip Codes are visually distinctive, scannable codes that launch App Clip experiences on iOS devices — lightweight app experiences that can be discovered without installing the full app.
49+
50+
The tool generates App Clip Codes as SVG files with two code types: **cam** codes that are scannable by the device camera, and **nfc** codes that additionally support Near Field Communication for tap-to-open functionality. The **suggest** command validates that foreground and background color combinations meet Apple's contrast and readability requirements.
51+
52+
App Clip Codes encode a URL that maps to a registered App Clip experience through Apple's App Store Connect configuration.
53+
54+
# CAVEATS
55+
56+
Available only on **macOS** as part of Apple's developer tools. The tool must be downloaded separately from Apple's App Clip resources page. Generated codes require a registered App Clip experience configured in **App Store Connect** to function. Color combinations must meet Apple's contrast requirements — use the **suggest** command to validate colors before generating.
57+
58+
# HISTORY
59+
60+
AppClipCodeGenerator was released by **Apple** alongside **App Clips** in **iOS 14** (2020). App Clips were introduced at **WWDC 2020** as a way to provide focused app experiences discoverable through Safari, Maps, NFC tags, and QR codes. The code generator tool enables developers to create the proprietary App Clip Code format that is visually distinct from standard QR codes.
61+
62+
# SEE ALSO
63+
64+
[xcodebuild](/man/xcodebuild)(1), [xcrun](/man/xcrun)(1)

assets/commands/index.txt

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,7 @@ aichat.md
124124
aide.md
125125
aider.md
126126
aim.md
127+
aimock.md
127128
air.md
128129
airbase-ng.md
129130
aircrack-ng.md
@@ -223,6 +224,7 @@ apm_available.md
223224
apparmor.md
224225
apparmor_parser.md
225226
apparmor_status.md
227+
appclipcodegen.md
226228
apply.md
227229
appman.md
228230
apport-bug.md
@@ -3833,6 +3835,7 @@ latte-dock.md
38333835
launchctl.md
38343836
lavadecode.md
38353837
laydown.md
3838+
lazyagent.md
38363839
lazycelery.md
38373840
lazycut.md
38383841
lazydocker.md
@@ -4222,6 +4225,7 @@ mcomp.md
42224225
mcookie.md
42234226
mcopy.md
42244227
mcp-probe.md
4228+
mcptube.md
42254229
mcs.md
42264230
md5sum.md
42274231
mdadm.md
@@ -4237,6 +4241,7 @@ mdk4.md
42374241
mdm.md
42384242
mdns-scanner.md
42394243
mdp.md
4244+
mdpdf.md
42404245
mdtt.md
42414246
mediainfo.md
42424247
mediamtx.md
@@ -6361,6 +6366,7 @@ register_new_matrix_user.md
63616366
regname.md
63626367
rehash.md
63636368
reindexdb.md
6369+
rekal.md
63646370
rekor-cli.md
63656371
relic.md
63666372
remind.md
@@ -6398,6 +6404,7 @@ restorecond.md
63986404
retroarch.md
63996405
reuse.md
64006406
rev.md
6407+
revdiff.md
64016408
rexec.md
64026409
rexi.md
64036410
rfkill.md
@@ -6836,6 +6843,7 @@ smbmap.md
68366843
smbnetfs.md
68376844
smbpasswd.md
68386845
smem.md
6846+
smolvm.md
68396847
sn.md
68406848
snake4.md
68416849
snake4scores.md
@@ -7232,6 +7240,7 @@ systemsettings.md
72327240
systeroid.md
72337241
systool.md
72347242
t-rec.md
7243+
t4.md
72357244
tabby.md
72367245
tabiew.md
72377246
tabix.md
@@ -7907,6 +7916,7 @@ vulkaninfo.md
79077916
vzdump.md
79087917
w.md
79097918
w3m.md
7919+
wacli.md
79107920
wafw00f.md
79117921
waifu2x-ncnn-vulkan.md
79127922
wait.md

assets/commands/lazyagent.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# TAGLINE
2+
3+
Monitor all your coding agent sessions from one terminal
4+
5+
# TLDR
6+
7+
**Launch** the terminal UI monitoring all agents
8+
9+
```lazyagent```
10+
11+
**Monitor only** Claude Code sessions
12+
13+
```lazyagent --agent claude```
14+
15+
**Monitor only** Cursor sessions
16+
17+
```lazyagent --agent cursor```
18+
19+
**Start** the HTTP API server
20+
21+
```lazyagent --api```
22+
23+
**Start the API** on a custom address
24+
25+
```lazyagent --api --host [":8080"]```
26+
27+
**Launch** as a macOS menu bar app
28+
29+
```lazyagent --gui```
30+
31+
**Run all three** interfaces simultaneously
32+
33+
```lazyagent --tui --gui --api```
34+
35+
# SYNOPSIS
36+
37+
**lazyagent** [_options_]
38+
39+
# PARAMETERS
40+
41+
**--agent** _name_
42+
> Filter to a specific agent: claude, cursor, opencode, pi, codex, amp, or all (default: all)
43+
44+
**--tui**
45+
> Launch the terminal UI (default when no interface is specified)
46+
47+
**--gui**
48+
> Launch as a macOS menu bar app
49+
50+
**--api**
51+
> Start the HTTP API server with Server-Sent Events for real-time updates
52+
53+
**--host** _address_
54+
> Custom API listen address (default: :3333)
55+
56+
**--help**
57+
> Display help information
58+
59+
# DESCRIPTION
60+
61+
**lazyagent** is a terminal UI, macOS menu bar app, and HTTP API for monitoring all running coding agent instances on your machine. It supports **Claude Code**, **Cursor**, **OpenCode**, **pi**, **Codex CLI**, and **Amp**.
62+
63+
Unlike other tools, lazyagent does not replace or modify your workflow — it is purely observational. Launch agents wherever you want (terminal, IDE, desktop app) and lazyagent watches session data to determine what each session is doing. No modifications to any agent are needed.
64+
65+
The HTTP API provides a read-only REST interface with Server-Sent Events for real-time push updates, allowing custom dashboards, mobile apps, or integration with existing tools.
66+
67+
# CAVEATS
68+
69+
The macOS menu bar app (**--gui**) is available on macOS only; the TUI works cross-platform. lazyagent is read-only and cannot control or modify agent behavior. Building from source requires **Go 1.25+** and **Node.js 18+** for the frontend components.
70+
71+
# HISTORY
72+
73+
lazyagent was created by **Illegal Studio** and written primarily in **Go** with a **Svelte** frontend for the menu bar app. It was first released in **2025** to address the growing need for developers running multiple AI coding agents simultaneously to have a unified monitoring view.
74+
75+
# SEE ALSO
76+
77+
[tmux](/man/tmux)(1), [htop](/man/htop)(1), [lazygit](/man/lazygit)(1)

0 commit comments

Comments
 (0)