Skip to content

CLI hooks for Warp's built-in tools (markdown viewer, editor, split panes) #8741

@mrlerch

Description

@mrlerch

[###]Pre-submit Checks

Describe the solution you'd like?

Warp has excellent built-in tools — the markdown viewer, the file editor, split pane management — but they're only accessible through GUI interactions (clicking file paths, keyboard shortcuts). There's no way to trigger them programmatically from the terminal.

A warp CLI tool (or extending the existing one) that exposes hooks for these internal tools would make Warp truly scriptable and open up powerful automation workflows.

Proposed CLI hooks:

Markdown viewer/editor:
• warp open --viewer file.md — open a file in Warp's rendered markdown viewer panel
• warp open --editor file.md — open a file in a visual markdown editor (WYSIWYG, no markup knowledge required)
• warp open --viewer --split right --size 33% file.md — open viewer in a right split at a specific width

Split pane management:
• warp split right — programmatically open a right split
• warp split right --size 33% — open a split at a specific width ratio
• warp split right --run "command" — open a split and run a command in it
• warp split close — close the current split pane

File tools:
• warp open file.txt — open any file in Warp's built-in viewer/editor
• warp open --diff file1.txt file2.txt — open a diff view

Use cases:
• Custom cheat / help aliases that open a personal reference sheet in the markdown viewer alongside work
• CI/CD scripts that display formatted reports in Warp's viewer
• Workflow automation: one command that opens a split pane with logs/docs while you work
• Editing markdown files (READMEs, docs, notes) visually without knowing markdown syntax — especially valuable for users who aren't developers but use the terminal
• AppleScript/Automator currently being the only (fragile) workaround for any of this

Why this matters:
Warp already has these tools built in — they're polished and they work great. Exposing them via CLI hooks would be low-friction for the Warp team while dramatically increasing what users and AI agents (Warp AI, Claude Code, etc.) can do. It would make Warp the first terminal that's fully scriptable as an IDE-like environment, not just a shell.

Also, if there is any way to make a clickable TOC inside a .md maybe specifically in a Warp .md, that would be totally awesome :)

Is your feature request related to a problem? Please describe.

a attempting to write a shortcut to open a help.md file in with the built in .md viewer in Warp in a 2/3 1/3 split .. like a help window / cheat sheet window.

Additional context

Love Warp. Will probably never use the original macOS terminal again.

Operating system (OS)

macOS

How important is this feature to you?

5 (Can't work without it!)

Image

Warp Internal (ignore) - linear-label:39cc6478-1249-4ee7-950b-c428edfeecd1

None

Metadata

Metadata

Assignees

No one assigned

    Labels

    FEATUREFeature Requests

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions