create-agent-tui — Claude Code skill: scaffold terminal agents in minutes
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.
no license 358 installs ★ 327 updated 2026-11-06
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a claude-codeWhat create-agent-tui 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.
What it helps with
- 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 for the agent
- 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
How to install create-agent-tui
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a claude-code2Manually: put the files in place
~/.claude/skills/create-agent-tui/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/create-agent-tui/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a codex2Manually: put the files in place
.agents/skills/create-agent-tui/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a cursor2Manually: put the files in place
.cursor/skills/create-agent-tui/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OpenRouterTeam/skills skills/create-agent-tui2Manually: put the files in place
.github/skills/create-agent-tui/SKILL.md1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a gemini-cli2Platform CLI
gemini skills install https://github.com/OpenRouterTeam/skills --path skills/create-agent-tuiManually: put the files in place
.devin/skills/create-agent-tui/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-agent-tui -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about create-agent-tui
How do I install create-agent-tui in Claude Code?
Run npx skills add OpenRouterTeam/skills --skill create-agent-tui -a claude-code, then open the file ~/.claude/skills/create-agent-tui/SKILL.md.
What does create-agent-tui do?
The skill generates a full TypeScript agent project with a terminal interface, tools (file read/write, search, shell execution), and session persistence. Once generated, the project runs immediately and you can customize it for your use case.
What do I need to use it?
Node.js 18 or later and an OpenRouter API key in the OPENROUTER_API_KEY environment variable. During generation, the skill presents a checklist—select the tools and modules you want, and the rest is scaffolded automatically.