Cursor CLI Passthrough (cursor-tui) for Openclaw

A transparent bridge that spawns and relays Cursor Agent's CLI sessions directly to the user, making it one of the most essential Openclaw Skills for terminal-based AI development.

waldyrious
v1.0.1
Mar 2, 2026
1
1.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install cursor-tui

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install cursor-tui using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Cursor CLI Passthrough (cursor-tui)?

The Cursor CLI Passthrough is a sophisticated tool within the ecosystem of Openclaw Skills that enables developers to run the Cursor Agent's command-line binary as a background process while maintaining full interactive control. By spawning a PTY session, it acts as a transparent bridge, relaying every line of output and every user command without unnecessary interpretation or commentary. This allows developers to harness the full power of Cursor's AI directly within their preferred terminal environment.

Unlike traditional integrations, this skill focuses on fidelity. It preserves the agent's logic, permission prompts, and contextual awareness while providing a structured way to handle multi-line inputs and special keystrokes. Whether you are debugging a complex module or refactoring a directory, this skill ensures that the AI agent remains accessible and responsive throughout your development lifecycle.

Cursor CLI Passthrough (cursor-tui) Use Cases

  • Interactive project-wide code generation or debugging using Cursor's agent CLI.
  • Running Cursor Agent in specific project directories while maintaining workspace trust controls.
  • Executing multi-line AI prompts with file and directory context using the @ syntax.
  • Managing long-running AI sessions within a terminal-based development workflow.

How Cursor CLI Passthrough (cursor-tui) Works

  1. The skill spawns the Cursor agent binary in a PTY background session within a specified project directory.
  2. It handles initial workspace trust prompts by relaying the interactive choices (accept, workspace, or quit) to the user.
  3. The system continuously polls the session for output, stripping ANSI escape codes while relaying content verbatim.
  4. User inputs are captured and submitted as single-line data or pasted as multi-line text blocks.
  5. Special key commands, such as arrow keys or Enter, are sent to the session to handle interactive menus or approval dialogs.
  6. The session is terminated gracefully via standard commands like /quit or Ctrl+D signals.

Cursor CLI Passthrough (cursor-tui) Setup

To begin using this entry from the Openclaw Skills library, you must have the Cursor binary installed on your system. The tool requires either the cursor or cursor-agent binary to be present in your system PATH.

Verify your installation with the following command:

cursor --version

If the command is not recognized, you may need to add the Cursor binary location to your shell configuration or check your environment specific binary path settings.

Cursor CLI Passthrough (cursor-tui) Data Schema & Taxonomy

This skill organizes interactive session data using the following structure to ensure clarity and process control:

Property Description
sessionId Unique identifier for the active PTY background session.
workdir The absolute path to the project directory where the agent is active.
output Verbatim text stream from the Cursor CLI binary, stripped of ANSI codes.
prompt Formatted status line showing cursor @ <workdir> for user context.

Cursor CLI Passthrough (cursor-tui) Advanced Features

  • Support for workspace trust negotiation through interactive PTY key relay.
  • Integration with project context via the @ symbol for referencing specific files and folders.
  • Automated prompt formatting that uses relative paths (~) for better readability.
  • Multi-line prompt support via the paste action for complex coding instructions.
  • Interactive passthrough for approval dialogs, ensuring the user remains in control of command execution.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins cursorcursor-agent
Github Stars: 0
forks: 0

Featured*