ralph-tui-create-linear
🎯Skillfrom teknologist/ralph-tui
|Creates a Linear issue or task within the Ralph TUI workflow, enabling seamless integration of project management tasks with the AI-driven task automation system.
Installation
npx skills add https://github.com/teknologist/ralph-tui --skill ralph-tui-create-linearSkill Details
Overview
# Ralph TUI
[](https://www.npmjs.com/package/ralph-tui)
[](https://github.com/subsy/ralph-tui/actions/workflows/ci.yml)
[](https://codecov.io/gh/subsy/ralph-tui)
[](https://opensource.org/licenses/MIT)
[](https://bun.sh)
AI Agent Loop Orchestrator - A terminal UI for orchestrating AI coding agents to work through task lists autonomously.
Ralph TUI connects your AI coding assistant (Claude Code, OpenCode, Factory Droid, Gemini CLI, Codex, Kiro CLI) to your task tracker and runs them in an autonomous loop, completing tasks one-by-one with intelligent selection, error handling, and full visibility.
Quick Start
```bash
# Install
bun install -g ralph-tui
# Setup your project
cd your-project
ralph-tui setup
# Create a PRD with AI assistance
ralph-tui create-prd --chat
# Run Ralph!
ralph-tui run --prd ./prd.json
```
That's it! Ralph will work through your tasks autonomously.
Documentation
[ralph-tui.com](https://ralph-tui.com) - Full documentation, guides, and examples.
Quick Links
- [Quick Start Guide](https://ralph-tui.com/docs/getting-started/quick-start) - Get running in 2 minutes
- [Installation](https://ralph-tui.com/docs/getting-started/installation) - All installation options
- [CLI Reference](https://ralph-tui.com/docs/cli/overview) - Complete command reference
- [Configuration](https://ralph-tui.com/docs/configuration/overview) - Customize Ralph for your workflow
- [Troubleshooting](https://ralph-tui.com/docs/troubleshooting/common-issues) - Common issues and solutions
How It Works
```
┌─────────────────────────────────────────────────────────────────┐
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 1. SELECT │────▶│ 2. BUILD │────▶│ 3. EXECUTE │ │
│ │ TASK │ │ PROMPT │ │ AGENT │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ ▲ │ │
│ │ ▼ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ 5. NEXT │◀────────────────────────│ 4. DETECT │ │
│ │ TASK │ │ COMPLETION │ │
│ └──────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
```
Ralph selects the highest-priority task, builds a prompt, executes your AI agent, detects completion, and repeats until all tasks are done.
Features
- Task Trackers: prd.json (simple), Beads (git-backed with dependencies), Linear (read-only)
- AI Agents: Claude Code, OpenCode, Factory Droid, Gemini CLI, Codex, Kiro CLI
- Session Persistence: Pause anytime, resume later, survive crashes
- Real-time TUI: Watch agent output, control execution with keyboard shortcuts
- Subagent Tracing: See nested agent calls in real-time
- Cross-iteration Context: Automatic progress tracking between tasks
- Flexible Skills: Use PRD/task skills directly in your agent or via the TUI
- Remote Instances: Monitor and control ralph-tui running on multiple machines from a single TUI
CLI Commands
| Command | Description |
|---------|-------------|
| ralph-tui | Launch the interactive TUI |
| ralph-tui run [options] | Start Ralph execution |
| ralph-tui resume | Resume an interrupted session |
| ralph-tui status | Check session status |
| `ralph-tui lo