Development

Command

/stop

Stop a running agent

Boost this command

ruvnet@ruvnet

GitHub

From plugin

ruvnet-ruflo

73k196 skills160 agents196 commands1 MCP

Install

> /plugin marketplace add ruvnet/ruflo

How it fires

How this command gets triggered: by you, by Claude, or both.

Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/stop

Context preview

What this command does when you run it.

Stop a running agent

Command definition

stop.md

name: stop
description: Stop a running agent
aliases: [kill]
type: command

Agent Stop Command

Stop a running agent with graceful or forced shutdown options.

Usage

npx @claude-flow/cli@latest agent stop <agent-id> [options]
npx @claude-flow/cli@latest agent kill <agent-id> [options]  # Alias

Options

| Option | Short | Description | Default | |--------|-------|-------------|---------| | `--force` | `-f` | Force stop without graceful shutdown | false | | `--timeout` | | Graceful shutdown timeout in seconds | 30 |

Examples

# Graceful stop (completes current task)
npx @claude-flow/cli@latest agent stop coder-lx7m9k2

# Force stop (immediate termination)
npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --force

# Custom shutdown timeout
npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --timeout 60

# Using kill alias
npx @claude-flow/cli@latest agent kill researcher-abc123 -f

Graceful vs Force Stop

Graceful Shutdown (Default)

1. Completes current task 2. Saves agent state to memory 3. Releases resources cleanly 4. Notifies swarm coordinator

npx @claude-flow/cli@latest agent stop coder-lx7m9k2

# Output:
# Stopping agent coder-lx7m9k2...
#   Completing current task...
#   Saving state...
#   Releasing resources...
# Agent coder-lx7m9k2 stopped successfully

Force Stop

1. Immediate termination 2. No state preservation 3. May leave tasks incomplete

npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --force

# Output:
# Stopping agent coder-lx7m9k2...
# Agent coder-lx7m9k2 stopped successfully

Interactive Confirmation

Without `--force`, you'll be prompted to confirm:

? Are you sure you want to stop agent coder-lx7m9k2? (y/N)

Batch Operations

To stop multiple agents:

# Stop all agents of a type
npx @claude-flow/cli@latest agent list -t coder --format json | \
  jq -r '.agents[].id' | \
  xargs -I {} npx @claude-flow/cli@latest agent stop {} -f

# Stop all idle agents
npx @claude-flow/cli@latest agent list -s idle --format json | \
  jq -r '.agents[].id' | \
  xargs -I {} npx @claude-flow/cli@latest agent stop {}

Related Commands

`npx @claude-flow/cli@latest agent list` - Find agent IDs
`npx @claude-flow/cli@latest agent status` - Check status before stopping
`npx @claude-flow/cli@latest swarm destroy` - Stop all agents in swarm

Read it on GitHub ↗

Ships withruvnet-ruflo

An agent meta-harness for Claude Code and Codex. 📖 RuFlo Explained — Build an AI Team That Plans, Remembers, Tests, and Improves A 14-chapter guide: from the basic idea to a first useful task, then memory, agent teams, plugins, cost and verification.

Get the whole plugin

Stats

TypeScript React Bash Rust Linux

+7 tags

Git GitHub GitHub Actions Anthropic OpenAI Gemini MCP

71,967

Stars

8,512

Forks

Active

Maintenance

TypeScript