claudegoodies
Command

stop

From ruvnet

Stop a running agent

Install

/stop

Facts

Repository
ruvnet/ruflo
Status
Actively maintained
Last commit
Source file
v3/@claude-flow/cli/.claude/commands/agents/stop.md

Source preview

The instructions Claude Code reads when this command runs.

# Agent Stop Command

Stop a running agent with graceful or forced shutdown options.

## Usage

```bash
npx claude-flow agent stop <agent-id> [options]
npx claude-flow 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

```bash
# Graceful stop (completes current task)
npx claude-flow agent stop coder-lx7m9k2

# Force stop (immediate termination)
npx claude-flow agent stop coder-lx7m9k2 --force

# Custom shutdown timeout
npx claude-flow agent stop coder-lx7m9k2 --timeout 60

# Using kill alias
npx claude-flow 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

```bash
npx claude-flow 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

```bash
npx claude-flow agent stop coder-lx7m9k2 --force

# Output:
# Stopping agent coder-lx7m9k2...
# Agent coder-lx7m
View full source on GitHub →

Other slash commands