# Tui Installer

> Use to install (or just plan) the recommended terminal/TUI stack for driving multiple AI coding agents on Ubuntu — zellij + claude-squad + lazygit + delta. Dry-run by default (prints the plan, installs nothing); --apply asks y/N per tool. When onboarding agent-harness, offer to run --check and ask before installing anything.

- **Type:** Skill
- **Install:** `agentstack add skill-jajupmochi-agent-harness-tui-installer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jajupmochi](https://agentstack.voostack.com/s/jajupmochi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jajupmochi](https://github.com/jajupmochi)
- **Source:** https://github.com/jajupmochi/agent-harness/tree/main/skills/tui-installer

## Install

```sh
agentstack add skill-jajupmochi-agent-harness-tui-installer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# tui-installer

Overhaul task 8 (installer half). Turns the recommendation in `recommendations/tui-for-agents.md` into a
runnable, **ask-first** installer. Nothing installs unless the user opts in.

## Use

```
bash scripts/install-tui.sh --check    # report what's installed vs missing
bash scripts/install-tui.sh            # dry-run: print the install plan, install NOTHING (default)
bash scripts/install-tui.sh --apply    # install missing tools, asking y/N per tool
```

The recommended stack (see the recommendation doc for why): **zellij** (multiplexer), **claude-squad** (agent
orchestrator, git-worktree isolation), **lazygit** (diff review + staging), **delta** (highlighted diffs).
Tools without a clean apt/cargo package (claude-squad, lazygit on some distros) are marked `MANUAL:` with the
upstream install URL rather than a fabricated command.

## Onboarding behavior (task 8)

When applying agent-harness to a machine, run `--check` and **ask the user whether to install** the missing
TUI tools — never install unprompted. Re-check periodically (or when the recommendation doc changes) and ask
again if a better tool appears; keep the tool list in sync with `recommendations/tui-for-agents.md`.

## Why dry-run default + fake-install seam

Installing system tools is side-effectful, so the default only *plans*. The detection is testable without
touching the system via `TUI_FAKE_INSTALLED="zellij delta"` (used by `test_install_tui.sh`, 11/11). The actual
package installs are the only non-deterministic part and stay behind `--apply` + a y/N prompt.

Status: v0.1 (check / dry-run plan / apply-with-prompt, tested). Planned: keep the tool table generated from
the recommendation doc, and a "notify when a better tool ships" tie-in with `agent-update-watcher`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jajupmochi](https://github.com/jajupmochi)
- **Source:** [jajupmochi/agent-harness](https://github.com/jajupmochi/agent-harness)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jajupmochi-agent-harness-tui-installer
- Seller: https://agentstack.voostack.com/s/jajupmochi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.