From devteam
Resets DevTeam sessions, clears history and state, aborts stuck processes, and recovers from errors via /devteam:reset command with options like --full, --clear-history.
How this skill is triggered — by the user, by Claude, or both
Slash command
/devteam:devteam-resetThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Command:** `/devteam:reset [options]`
Command: /devteam:reset [options]
Reset state, clear stuck sessions, and recover from errors.
# Abort current session and reset state
/devteam:reset
# Abort with specific reason
/devteam:reset --reason "Changing approach"
# Clear all session history (keep plans)
/devteam:reset --clear-history
# Full reset (clear everything except config)
/devteam:reset --full
# Reset specific session
/devteam:reset --session session-20260129-103045-abc123
# Dry run (show what would be reset)
/devteam:reset --dry-run
| Option | Description |
|---|---|
--reason <text> | Reason for reset (logged) |
--clear-history | Clear all session history |
--full | Full reset (sessions, history, temp files) |
--session <id> | Reset specific session |
--dry-run | Show what would be reset without doing it |
--force | Skip confirmation prompts |
source "${CLAUDE_PLUGIN_ROOT}/scripts/state.sh"
source "${CLAUDE_PLUGIN_ROOT}/scripts/events.sh"
# Check for running session
if is_session_running; then
SESSION_ID=$(get_current_session_id)
# Log the abort
log_event "session_aborted" "system" "User initiated reset" \
"{\"reason\": \"$REASON\"}"
# End session
end_session "aborted" "${REASON:-User reset}"
echo "Session $SESSION_ID aborted."
else
echo "No active session to reset."
fi
# Reset circuit breaker state
sqlite3 "$DB_FILE" "
UPDATE sessions
SET circuit_breaker_state = 'closed',
consecutive_failures = 0
WHERE status = 'running';
"
if [[ "$CLEAR_HISTORY" == "true" ]]; then
# Confirm
if [[ "$FORCE" != "true" ]]; then
read -p "Clear all session history? This cannot be undone. [y/N] " confirm
if [[ "$confirm" != "y" && "$confirm" != "Y" ]]; then
echo "Cancelled."
exit 0
fi
fi
# Clear history tables
sqlite3 "$DB_FILE" "
DELETE FROM events;
DELETE FROM agent_runs;
DELETE FROM gate_results;
DELETE FROM escalations;
DELETE FROM interviews;
DELETE FROM interview_questions;
DELETE FROM research_sessions;
DELETE FROM research_findings;
DELETE FROM sessions WHERE status != 'running';
"
echo "Session history cleared."
fi
if [[ "$FULL_RESET" == "true" ]]; then
# Confirm
if [[ "$FORCE" != "true" ]]; then
read -p "Full reset? This will clear all sessions and history. Plans will be preserved. [y/N] " confirm
if [[ "$confirm" != "y" && "$confirm" != "Y" ]]; then
echo "Cancelled."
exit 0
fi
fi
# Backup database first
BACKUP_FILE="${DB_FILE}.backup-$(date +%Y%m%d-%H%M%S)"
cp "$DB_FILE" "$BACKUP_FILE"
echo "Backup created: $BACKUP_FILE"
# Clear all session-related data
sqlite3 "$DB_FILE" "
DELETE FROM events;
DELETE FROM agent_runs;
DELETE FROM gate_results;
DELETE FROM escalations;
DELETE FROM interviews;
DELETE FROM interview_questions;
DELETE FROM research_sessions;
DELETE FROM research_findings;
DELETE FROM bugs;
DELETE FROM session_state;
DELETE FROM sessions;
"
# Clean up temp files
rm -f .devteam/autonomous-mode
rm -f .devteam/current-task.txt
rm -f .devteam/escalation-trigger
echo "Full reset complete. Database backup: $BACKUP_FILE"
fi
DevTeam Reset
Current Session: session-20260129-103045-a1b2c3
Status: running (iteration 5)
Command: /devteam:implement --sprint 1
Resetting...
Session aborted
Circuit breaker reset
Temp files cleared
Reset complete. Ready for new session.
DevTeam Reset (Dry Run)
The following actions would be taken:
[SESSION] Abort session-20260129-103045-a1b2c3
- Status: running -> aborted
- Iterations completed: 5
- Cost incurred: $2.34
[STATE] Reset circuit breaker
- Current failures: 3 -> 0
- State: half-open -> closed
[FILES] Remove temp files
- .devteam/autonomous-mode
- .devteam/current-task.txt
No changes made. Remove --dry-run to execute.
DevTeam Reset (Clear History)
WARNING: This will permanently delete:
Sessions: 47 records
Events: 2,341 records
Agent Runs: 892 records
Gate Results: 1,203 records
Escalations: 124 records
Plans and configuration will be preserved.
Clear all session history? This cannot be undone. [y/N] y
Sessions cleared
Events cleared
Agent runs cleared
Gate results cleared
Escalations cleared
History cleared. Lifetime statistics reset.
If a session appears stuck:
# Check what's happening
/devteam:status
# If truly stuck, reset
/devteam:reset --reason "Session stuck on iteration 8"
# Check status
/devteam:status
# Shows: Circuit Breaker: OPEN (5 consecutive failures)
# Reset to retry
/devteam:reset
# Then retry with different approach
/devteam:implement --sprint 1 --model sonnet
# If database is corrupted
/devteam:reset --full
# Or reinitialize
rm .devteam/devteam.db
bash scripts/db-init.sh
.devteam/config.yaml - Project configuration.devteam/agent-capabilities.yaml - Agent registry.devteam/plans/ - Plan filesdocs/planning/ - PRDs and planning docs/devteam:status - Check current state before reset/devteam:implement - Start new implementation after resetnpx claudepluginhub michael-harris/devteam --plugin devteamDisplays DevTeam session status, sprint/task progress, model usage costs, agent metrics, quality gates, escalations, and execution history. Ideal for monitoring agent-based dev workflows.
Manages persistent state across Claude Code agent sessions: load context at start, track progress/decisions/learnings, save for next session. Use when resuming work or hitting blockers.
Orchestrates Claude Code multi-agent teams with lifecycle management, failure recovery, idle guardrails, and degraded mode fallback. Invoked when creating or managing agent teams.