Skip to content

Commit 8e43809

Browse files
committed
Add commands
Document kh (kakehashi), legionlinuxtui, symbio, banksia, and wienerdog from Hacker News discovery.
1 parent 6c840a5 commit 8e43809

6 files changed

Lines changed: 513 additions & 0 deletions

File tree

‎assets/commands/banksia.md‎

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
# TAGLINE
2+
3+
CLI for accountable multi-agent AI teams with a local web console
4+
5+
# TLDR
6+
7+
**Install** with pipx and initialize
8+
9+
```pipx install banksia```
10+
11+
```banksia init```
12+
13+
**Start** the local controller and open the console
14+
15+
```banksia serve```
16+
17+
**Show** status (also the default with no subcommand)
18+
19+
```banksia```
20+
21+
```banksia status```
22+
23+
**Configure** a Task provider
24+
25+
```banksia setup```
26+
27+
```banksia providers list```
28+
29+
**Optional PostgreSQL** install path
30+
31+
```pipx install "banksia[postgres]"```
32+
33+
```banksia init --database-url [postgresql+asyncpg://…]```
34+
35+
# SYNOPSIS
36+
37+
**banksia** [**--debug**] [**-V**|**--version**] [_subcommand_] [_options_]
38+
39+
# DESCRIPTION
40+
41+
**banksia** is a command-line application and local runtime for building and running **accountable AI teams** on complex work. Workflows define a responsibility tree (not a fixed script). Managers can replan, parallelize, or iterate; progress and the lead's final Result are durable controller state, with deliverables kept as ordinary workspace files.
42+
43+
The package ships a visual **Console** (browser UI). After **banksia init** and **banksia serve**, open **http://127.0.0.1:18125/** (default). Initialization can configure a Task provider and an optional conversational **Operator** that uses the same controller operations as the UI. Default storage is **SQLite**; PostgreSQL is optional via **banksia[postgres]**.
44+
45+
Managed providers include Codex and Claude. Requires **Python 3.12+**; Linux and macOS are supported (native Windows is not; WSL2 uses the Linux path). Install with **pipx install banksia**.
46+
47+
# PARAMETERS
48+
49+
**(no subcommand)** / **status**
50+
> Print controller status (default when no subcommand is given).
51+
52+
**init** [**--data-dir** _dir_] [**--database-url** _url_] [**--workspace** _dir_] [**--host** _addr_] [**--port** _n_] [**--log-level** _level_] [**--force**] [**--skip-db-upgrade**] [**--non-interactive**] …
53+
> Initialize local controller state; optionally configure Task provider and Operator.
54+
55+
**serve**
56+
> Start the local API/controller process that serves the Console and runtime.
57+
58+
**setup**
59+
> Guided provider setup for Task work.
60+
61+
**providers** **list**|**status**|**check**|**configure**|**identity**|**set-default** …
62+
> Inspect and configure LLM/providers.
63+
64+
**operator** **setup**|**status**|**disable** …
65+
> Manage the conversational Operator agent.
66+
67+
**config** **show**|**path** …
68+
> Show configuration or its path.
69+
70+
**workflow** **import**|**export** …
71+
> Import or export Workflow definitions.
72+
73+
**task** **start** …
74+
> Start a Task/run from the CLI.
75+
76+
**--debug**
77+
> Include a traceback when a command fails.
78+
79+
**-V**, **--version**
80+
> Print package version.
81+
82+
# CONFIGURATION
83+
84+
**Local data directory** (set during **init** / **--data-dir**)
85+
> Controller state, SQLite database by default, and runtime files.
86+
87+
**--database-url**
88+
> SQLAlchemy URL for PostgreSQL (e.g. **postgresql+asyncpg://…**). Requires the **postgres** extra.
89+
90+
**--host** / **--port**
91+
> Bind address for the local API (default loopback and project default port **18125**).
92+
93+
**Default workspace**
94+
> Directory visible to Task members for files and managed actions.
95+
96+
# CAVEATS
97+
98+
Intended for a trusted local machine; the controller binds to loopback by default. Task members in a run share one provider-visible workspace. Console assets under **console/** use a Sustainable Use License (not pure MIT). Not a multi-tenant hosted service. Provider CLIs/SDKs and API credentials must be available for real runs.
99+
100+
# HISTORY
101+
102+
**Banksia** is an open-source accountable multi-agent runtime (MIT for the core; Console derived material under Sustainable Use License). Upstream: **github.com/ringlochid/banksia**. Distributed on PyPI as **banksia**.
103+
104+
# SEE ALSO
105+
106+
[pipx](/man/pipx)(1), [claude](/man/claude)(1), [codex](/man/codex)(1), [uvicorn](/man/uvicorn)(1)
107+
108+
# RESOURCES
109+
110+
```[Source code](https://github.com/ringlochid/banksia)```
111+
112+
```[Documentation](https://github.com/ringlochid/banksia/tree/main/docs)```
113+
114+
<!-- verified: 2026-08-02 -->

‎assets/commands/index.txt‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -629,6 +629,7 @@ balena.md
629629
ballast.md
630630
balooctl.md
631631
bandwhich.md
632+
banksia.md
632633
banner.md
633634
banshee.md
634635
baobab.md
@@ -3894,6 +3895,7 @@ keyd.md
38943895
keynav.md
38953896
keytool.md
38963897
kfp.md
3898+
kh.md
38973899
khal.md
38983900
kibi.md
38993901
kid3.md
@@ -4107,6 +4109,7 @@ ledctl.md
41074109
ledger.md
41084110
ledit.md
41094111
lefthook.md
4112+
legionlinuxtui.md
41104113
legit.md
41114114
lein.md
41124115
lemmeknow.md
@@ -7526,6 +7529,7 @@ sx.md
75267529
sxhkd.md
75277530
sxiv.md
75287531
syft.md
7532+
symbio.md
75297533
symfony.md
75307534
sync.md
75317535
syncthing.md
@@ -8467,6 +8471,7 @@ whoami.md
84678471
whohas.md
84688472
whois.md
84698473
whosthere.md
8474+
wienerdog.md
84708475
wifi-menu.md
84718476
wifite.md
84728477
wifitui.md

‎assets/commands/kh.md‎

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
# TAGLINE
2+
3+
Run macOS ARM64 binaries on Linux aarch64 (userspace translation layer)
4+
5+
# TLDR
6+
7+
**Install** the CLI and **ensure** a guest bottle
8+
9+
```cargo install kakehashi```
10+
11+
```kh bottle ensure```
12+
13+
**Install** Darwin guest tools into the bottle
14+
15+
```kh install 7zip```
16+
17+
```kh install curl```
18+
19+
**Run** a Darwin binary (guest args after **--**)
20+
21+
```kh run 7zz -- --help```
22+
23+
```kh run 7zz -- a demo.7z README.md```
24+
25+
**Inspect** a Mach-O binary without executing it
26+
27+
```kh inspect [path/to/binary] --sections --imports```
28+
29+
**Trace** syscalls for a guest binary
30+
31+
```kh trace [path/to/binary] -- [args]```
32+
33+
# SYNOPSIS
34+
35+
**kh** [**-v**...] [**--json**] _subcommand_ [_options_] [_args_]
36+
37+
# DESCRIPTION
38+
39+
**kh** is the command-line front end for **Kakehashi**, a userspace translation layer that loads Darwin **Mach-O** binaries (macOS ARM64) on **Linux aarch64**, maps a freestanding **libSystem**, and translates BSD syscalls so real guest tools can run without a JIT.
40+
41+
Live execution requires **Linux aarch64** (bare metal, VM, or Docker/Colima). Dry-load and inspect work on any host, including macOS. Guest tools are installed into a single **bottle** (default under the XDG data home, typically **~/.local/share/kakehashi/bottle/**), which provides a macOS-like filesystem layout; **/Volumes/linux/…** bridges to the host root.
42+
43+
Verified guest tools include Darwin **7zz** (7-Zip) and **curl**. Full Apple frameworks, GUI apps, codesign, and complete curl feature parity are not claimed. Install with **cargo install kakehashi** (Rust 1.88+).
44+
45+
# PARAMETERS
46+
47+
**-v**, **--verbose**
48+
> Increase log verbosity (repeatable). Overrides **KAKEHASHI_LOG** when set.
49+
50+
**--json**
51+
> Emit JSON where a subcommand supports it.
52+
53+
**inspect** [_path_] [**--sections**] [**--imports**] [**--find** _substr_] [**--load-commands**] [**--image**] [**--page-size** _bytes_] [**--host-page-size**]
54+
> Static Mach-O inspection without execution.
55+
56+
**run** _path_ [**--root** _dir_] [**--max-syscalls** _n_] [**--expect-code** _code_] [**--guest-page-size** _bytes_] [**--dry-load**] [**--**] [_guest_args_…]
57+
> Run a Mach-O binary under the translation layer. Guest argv follows the program name (often after **--** when using installed bottle names like **7zz**).
58+
59+
**trace** _path_ [**--root** _dir_] [**--max-events** _n_] [**--**] [_guest_args_…]
60+
> Capture syscall/trap events for a guest binary.
61+
62+
**bottle create|ensure|destroy|path|status**
63+
> Manage the registered bottle (**ensure** creates if missing and refreshes libSystem).
64+
65+
**install** _package_
66+
> Install a guest tool into the bottle. Packages include **7zip**, **curl**, **xcode-tools** (aliases **clt**, **git**), or **list**.
67+
68+
# CONFIGURATION
69+
70+
**KAKEHASHI_ROOT** / **--root**
71+
> Bottle root path.
72+
73+
**KAKEHASHI_DATA_DIR**, **KAKEHASHI_CONFIG_DIR**, **KAKEHASHI_CACHE_DIR**
74+
> Override XDG-style data, config, and cache locations.
75+
76+
**KAKEHASHI_LIBSYSTEM**
77+
> Path to guest **libSystem.B.dylib** (or freestanding equivalent) when not using the embedded copy.
78+
79+
**KAKEHASHI_LOG**
80+
> Tracing filter when **-v** is not set (default **warn**).
81+
82+
**KAKEHASHI_HYPERCALL**
83+
> Hypercall path is on by default for guest threads; set **0** only for debug.
84+
85+
**KAKEHASHI_FORCE_DOWNLOAD**, **KAKEHASHI_7ZZ**, **KAKEHASHI_CURL**, **KAKEHASHI_XCODE_TOOLS_VERSION**
86+
> Control optional guest-tool downloads and versions for **kh install**.
87+
88+
# CAVEATS
89+
90+
Live **run**/**trace** need **Linux aarch64** (4 KiB or 16 KiB pages). Not related to Darling; do not expect GUI, codesign, or full Apple Security.framework. Syscall-heavy multi-file workloads can be several times slower than native Linux tools. Experimental — guest support is expanding.
91+
92+
# HISTORY
93+
94+
**Kakehashi** is an open-source CLI-first userspace Darwin→Linux aarch64 translation layer (Apache-2.0). The shipped binary name is **kh**.
95+
96+
# SEE ALSO
97+
98+
[darling](/man/darling)(1), [wine](/man/wine)(1), [cargo](/man/cargo)(1), [7z](/man/7z)(1), [curl](/man/curl)(1)
99+
100+
# RESOURCES
101+
102+
```[Source code](https://github.com/wie-project/kakehashi)```
103+
104+
```[Documentation](https://github.com/wie-project/kakehashi/tree/main/docs)```
105+
106+
<!-- verified: 2026-08-02 -->

‎assets/commands/legionlinuxtui.md‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
# TAGLINE
2+
3+
Terminal UI for controlling Lenovo Legion laptops on Linux
4+
5+
# TLDR
6+
7+
**Run** the TUI (needs root for sysfs/driver I/O)
8+
9+
```sudo legionlinuxtui```
10+
11+
**Build** from source and run
12+
13+
```go build -o build/```
14+
15+
```sudo ./build/legionlinuxtui```
16+
17+
**Run** without installing (from a checkout)
18+
19+
```sudo go run .```
20+
21+
# SYNOPSIS
22+
23+
**legionlinuxtui**
24+
25+
# DESCRIPTION
26+
27+
**legionlinuxtui** is a terminal user interface for Lenovo **Legion** laptops on Linux. It reads sensor data and exposes capability toggles (for example conservative mode and power mode) through a full-screen TUI, refreshing sensor information about every 100 ms.
28+
29+
It depends on the community **Lenovo Legion Linux** kernel drivers (sysfs interfaces) and on **lm_sensors** being set up correctly on the machine. The process needs elevated privileges to talk to drivers and write sysfs values — invoke with **sudo** (or equivalent).
30+
31+
Written in Go. Packaging is available via Nix (NUR / flake packages from the author); otherwise build with Go ≥ 1.24.4 from the repository.
32+
33+
# PARAMETERS
34+
35+
No command-line options are required. Launch the binary; interaction is entirely through the TUI.
36+
37+
# CAVEATS
38+
39+
Requires Lenovo Legion hardware supported by [LenovoLegionLinux](https://github.com/johnfanv2/LenovoLegionLinux) drivers, plus a working **sensors** setup. Must run with privileges sufficient for driver/sysfs I/O. Not a generic laptop control tool for non-Legion machines.
40+
41+
# HISTORY
42+
43+
**legionlinuxtui** is an open-source Go TUI maintained at **github.com/nooneknowspeter/legionlinuxtui** under the MIT license.
44+
45+
# SEE ALSO
46+
47+
[sensors](/man/sensors)(1), [sensors-detect](/man/sensors-detect)(8), [amdgpu_top](/man/amdgpu_top)(1), [nvtop](/man/nvtop)(1)
48+
49+
# RESOURCES
50+
51+
```[Source code](https://github.com/nooneknowspeter/legionlinuxtui)```
52+
53+
<!-- verified: 2026-08-02 -->

0 commit comments

Comments
 (0)