AgentKit · Community TUI not the ak CLI MIT

AgentKit Helper

Community TUI: detect the ak CLI, ask a few choices, show the official command, then run it.

Start

Run the TUI

npx

npx --yes @thieung/agentkit-helper

Global install → short command

akh

npm install --global @thieung/agentkit-helper
akh

akh

↑ / ↓

Move

Space

Select multiple runtimes

Enter

Confirm this step

Esc

Back to the previous step

What it does

Wraps the ak CLI, does not replace it

Ask a few choices

Project or user/global scope, Engineer or Marketing Kit, runtimes, stable or beta channel.

Show the ak command

The helper prints the official ak CLI command before it writes anything.

Run it for you

It calls the ak CLI you already have. AgentKit still owns Kit verification, ownership, snapshots, and runtime files.

Compare

Helper vs ak CLI vs Desktop

ak CLI (official)

Source of truth: Kit install, update, ownership, snapshots. Every helper run is an ak command.

ak kit init / ak update / ak self-update
AgentKit remains responsible for ownership, snapshots, and runtime files.

Helper (community)

TUI asks choices then calls ak. Desktop App is the official GUI, sold separately — not this tool.

npx / akh — MIT, not an AgentKit product
Desktop: see the Desktop App page

Desktop App: Desktop guide . Manual CLI/kit updates: Update AgentKit .

Safety

--force is not the default

1

Global install: no --force first

The helper first runs without --force. If the target exists or files drifted, the TUI shows a WARNING and asks separately — default No. It retries with --force only after Yes.
2

Global update: preserve-only

User-modified files are skipped. The helper never adds --force on a global update.
3

Preview before write

akh update --dry-run plans without writing. --yes only skips the helper confirmation — it is not a wipe.

Platforms

macOS / Linux / Windows

macOS

Verified on a local machine

Linux

Supported via the portable Node.js path

Windows

PowerShell experimental — no real-machine smoke test yet

CLI

Advanced commands

Install into a project

akh

akh install --project /path/to/project --kit engineer \
  --runtime codex --channel stable

Install into runtime user/global

akh

akh install --global --kit engineer \
  --runtime codex,omp,pi --channel stable

Update Kit in a project

akh

akh update --project /path/to/project

Update every known install

akh

akh update-all --channel stable

ak binary only

akh

akh self-update --channel stable

Preview without writing

akh

akh update --project /path/to/project --dry-run

Install

claude-code codex cursor dsh grok omp pi

Update

claude-code codex cursor grok omp pi

dsh is unsupported for update

Export

agy portable

Every flag: akh --help.