create-agent-tui

What problem does it solve?

Building a customizable terminal agent UI from scratch requires handling low-level terminal rendering, tool integration, session persistence, and model call logic, which takes hours of manual work even for experienced developers.

Core Features & Use Cases

• Full Project Scaffolding: Generates a complete TypeScript project using @openrouter/agent for model calls, tool execution, and stop conditions, with pre-configured entry points and dependencies.
• Customizable Terminal UI: Choose from 3 input styles (block, bordered, plain), 4 tool display modes (emoji, grouped, minimal, hidden), 3 loader animations, and optional ASCII project banners.
• Configurable Tools & Modules: Toggle OpenRouter server tools (web search, datetime, image generation), 12+ client-side tools (file read/write/edit, shell, grep, etc.), and harness modules (session persistence, context compaction, tool approval, slash commands).
• Use Case: Build a custom coding assistant for your team, a CLI agent for internal tooling, or an embedded agent for your product without reimplementing the core agent loop.

Quick Start

Use the create-agent-tui skill to scaffold a new terminal agent project with grouped tool display, block input style, and session persistence enabled, then customize the tools and UI to match your needs.