Warp Agent 命令行工具
The Warp Agent CLI

原始链接: https://www.warp.dev/blog/introducing-the-warp-agent-cli-coding-agent

Warp 推出了 **Warp Agent CLI**,这是一款独立的、支持多种模型的工具,旨在为任何终端(包括 Ghostty、iTerm 2 和 VS Code)带来先进的智能代理功能。 该 CLI 构建于 Warp 的终端基础设施之上,充当智能多路复用器。这种独特的架构支持持久会话、目录切换,并能够直接通过代理控制全屏交互式应用程序(如 `sqlite` 或 `vim`)。 **主要功能包括:** * **原生集成:** 自动区分 Shell 命令与自然语言提示,并集成 Tab 键补全功能。 * **高级工作流:** 支持多代理协同、基于云的代理移交,以及将任务委托给 Claude Code 等外部工具的能力。 * **性能优化:** 内置模型路由功能,可在任务复杂性与成本效益之间取得平衡,同时支持前沿模型和开源模型。 * **远程功能:** 无需额外安装二进制文件,即可在远程机器上实现代理辅助工作流。 Warp Agent CLI 现已支持 Mac、Linux 和 Windows,用户可通过订阅、按需积分或自定义 API 密钥配置灵活使用。

近期发布的 Warp Agent CLI 在 Hacker News 上引发了关于 Warp 终端演进的激烈讨论。 Warp 最初因其简洁的界面、创新的块状输入(block-based input)和 shell 集成而备受赞誉,但如今却因“臃肿软件”(bloatware)和激进的 AI 集成而面临越来越多的批评。长期用户表示不满,认为该产品已将重心从高性能终端转向以 AI 为中心的平台,导致部分用户转而使用 WezTerm、iTerm2 或 Ghostty 等替代品。 争论的核心在于“垂直整合”(即 Warp 同时控制终端和 AI 代理)与对轻量化、模块化工具的需求之间的矛盾。尽管有些人欣赏在 AI 会话中直接运行交互式 shell 命令等功能,但批评者认为,这些功能往往更像是受风险投资驱动而进行的“AI 万能化”转型,而非出于用户需求。 尽管 Warp 的工程师公开保证 AI 功能是可选的且代码库是开放的,但许多高级用户仍持怀疑态度,更倾向于那些优先考虑终端功能而非内置专有代理生态的工具。这场讨论反映了开发者群体对工具中强制引入 AI 工作流的普遍疲劳感。
相关文章

原文

Highlights:

  • The Warp Agent is now available as a standalone CLI that you can use anywhere – Ghostty, iTerm 2, VS Code, built-in Windows and Mac Terminals – and provides a superior experience for developers who do heavy terminal workflows
  • The agent itself has built-in model-routing capabilities, comes with frontier and US-hosted open-weight models built in, and can even be customized with custom model routers.
  • The CLI has native support for advanced agent workflows, like multi-agent orchestration and cloud agents.
  • The CLI is built on Warp’s terminal infrastructure, which allows it to mux agent sessions natively – this unlocks capabilities beyond what is possible in other agents.

Today we are excited to launch the Warp Agent CLI, a new standalone CLI that lets you use the Warp Agent anywhere. It’s the same multi-model agent that’s built into Warp Terminal, now available in Ghostty, iTerm 2, VSCode, the built-in Windows terminal, or whatever terminal you prefer.

The Warp Agent CLI has everything you’d expect from a modern CLI coding agent: it’s a multi-model, cost-optimizing harness built for pro developers. Out of the box, you get access to frontier and open-weight models and auto-routing based on task complexity.

The CLI was truly built to fix gaps we were seeing with other agentic CLIs related to how well they integrate with the shell itself— especially important for developers doing real work in the terminal.

Technically, we accomplished this by building the CLI agent on top of Warp’s unique terminal infrastructure: think of our CLI agent as a built-in mux’er across agent sessions. This allows more natural interactions, like being able to switch directories in agent sessions, have the agent drive full-screen terminal commands (e.g. sqlite and mysql), and even run across ssh sessions with no remote binary install.

Let’s dive into the features that make the Warp Agent CLI extremely useful for folks who live in the terminal.

A multiplexing terminal agent

The Warp Agent CLI has a unique mux’ing architecture. Within an agent session, we are actually running and managing pty connections with a layer of indirection between the agent and the underlying shell, a similar architecture to how tmux works. The mux’ing is managed by Warp’s terminal infrastructure, so our agent is natively aware of terminal inputs and output (what we call “blocks” in Warp). This allows for a richer experience than any other CLI agent. Here are some of the features it unlocks.

Persistent sessions and remote agents

The Warp Agent CLI lets you switch directories while in an agent session, and even run agents on remote machines without installing remote binaries. This is all because the agent session continues even when the base “state” of the session changes.

Changing directories in an agent session.

Persistent sessions are useful when you are working across multi-repo projects, or when you want agent assistance on cloud machines where you might have limited permissions to install software.

Agent-driven full-screen and interactive apps

You can run full-screen and interactive terminal apps like sqlite and python through the agent session. Warp Agent can also control those apps. So within a REPL you can ask our agent to write queries or interactively debug code. Or you can ask the agent to quit vim…

Agent editing document using vim
Agent editing document using vim

For example, you can ask the Warp Agent to:

  • Generate SQL queries within a REPL and interactively debug data issues
  • Use a debugger like gdb to set breakpoints and debug running apps
  • Monitor system performance with htop

Seamless terminal input: autodetection and tab-completion

As with other CLI agents, you can use `!` to run a shell command. But Warp CLI also supports natural language detection: we ship with a classifier that automatically distinguishes shell commands from prompts, and invokes either the shell or agent accordingly.

Command completion menu
Command completion menu in Warp

The Warp Agent CLI has one of Warp Terminal’s flagship features: tab completions. Start typing a command, hit tab, and see suggestions for arguments and flags.

Great UI for advanced agent workflows

The Warp Agent CLI is built for the age of autonomous development, not just manually prompting agents. As such, it has full support for running cloud agents and orchestrating multi-agent workflows.

Unique to Warp, when you couple the Warp Agent with our cloud platform, our harness can delegate not just across subagents with different models, but with entirely different harnesses like Claude Code and Codex.

Choosing with agent harness to use for a cloud agent
Choosing with agent harness to use for a cloud agent

Automatic agent orchestration

Warp’s agent is an orchestration agent. It delegates to subagents to break apart hard tasks, with a native interface that makes it easy to see what each orchestrated agent is doing. You can even use arrow keys to switch between subagent and orchestrator agent sessions.

Warp managing subagents
Warp managing subagents with orchestration

Cloud agent handoff

Start work in the CLI, then hand it off to the cloud when you want to close your laptop. All cloud agents are tracked centrally and can be monitored and steered via the web so you can continue work on the go.

Cloud agent handoff menu
Cloud agent handoff via slash command

Cost-optimizing and customizable harness

Warp Agent is a pareto-efficient harness with auto-routing based on task complexity. Out of the box, it comes with access to frontier models and open-weight models.

We also have invested more to make open weight models great within our harness, with first class support for custom model routers where you define which models handle which tasks.

Custom router configuration with a yaml file
Custom router configuration file

How to get started

Install the CLI

Mac / Linux (Terminal):