# create-agent-tui

create-agent-tui is a Claude Code skill that generates a TypeScript agent with terminal UI, tools, and sessions for building an agent from scratch or adding a terminal interface.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 358 installs · ★ 327 repo stars
- Author: OpenRouterTeam
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OpenRouterTeam/skills/tree/HEAD/skills/create-agent-tui/SKILL.md
- Updated: 2026-11-06
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/create-agent-tui

## What it does

The skill does not write the agent for you — it sets up the frame: project structure, config, a tool layer (file read/write, search, shell execution), and a terminal UI out of the box.

Inside: typed TypeScript code with `@openrouter/agent` for model calls and tool dispatch. Outside: an interactive terminal shell with session history (JSONL), support for OpenRouter server-side tools (web search, datetime, image generation), and optional modules—context compaction, slash commands, approval gates for risky operations.

Requires Node.js 18+ and an `OPENROUTER_API_KEY`. The skill launches an interactive checklist—pick which tools and modules to enable, choose input and tool-display styles—then generates the whole project tailored to your choices.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/create-agent-tui/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/create-agent-tui/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/create-agent-tui/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/create-agent-tui/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OpenRouterTeam/skills skills/create-agent-tui
```

2. **Manually: put the files in place**
- File: `.github/skills/create-agent-tui/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OpenRouterTeam/skills --path skills/create-agent-tui
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/create-agent-tui/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OpenRouterTeam/skills/tree/HEAD/skills/create-agent-tui/SKILL.md

## When to use it
- scaffold a terminal agent with session persistence
- wire tools to an OpenRouter model (file I/O, search, shell, web fetch)
- customize terminal UI look and feel without rewriting core logic
- add optional harness modules (context compaction, commands, logging)

## Example prompts
- Generate a new agent for file operations with search and directory listing
- Build a TUI with session history, a slash command to switch models, and a plain input prompt
- Create an agent with web search, image generation, and approval before each shell command

## Similar
- [ratatui-tui](https://affpapa.org/en/nevibecode/skills/ratatui-tui.md) — skill · 959 installs
- [tui-design](https://affpapa.org/en/nevibecode/skills/tui-design.md) — skill · 1400 installs
- [tui-validate](https://affpapa.org/en/nevibecode/skills/tui-validate.md) — skill · ★ 3206 repo stars
- [tui-debug-in-pane](https://affpapa.org/en/nevibecode/skills/tui-debug-in-pane.md) — skill · ★ 3206 repo stars
- [tui-verify-change](https://affpapa.org/en/nevibecode/skills/tui-verify-change.md) — skill · ★ 720 repo stars
- [APP-4913-tui-input-prompt-prefix](https://affpapa.org/en/nevibecode/agents/app-4913-tui-input-prompt-prefix.md) — subagent · ★ 720 repo stars

From the same set: [openrouterteam/skills](https://affpapa.org/en/nevibecode/by/openrouterteam/skills.md) — 16 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
