Feature Request: Hot-reload agent definitions without restart

Resolved 💬 3 comments Opened Jan 30, 2026 by abudker Closed Feb 3, 2026

Summary

When iterating on agent definitions in .claude/agents/, changes only take effect after restarting Claude Code. This creates friction during agent development workflows.

Current Behavior

  • Agent definitions are loaded at session start
  • Modifying an existing agent file requires:
  1. Exiting Claude Code
  2. Restarting with claude --continue
  • The /agents command can load new agents but doesn't reload modified ones

Requested Feature

Add a way to hot-reload agent definitions without a full restart. Options could include:

  1. /reload command - Reload all agents, hooks, and plugins from disk
  2. /reload agents - Reload just agent definitions
  3. File watching - Automatically detect changes to .claude/agents/*.md files and reload
  4. Extend /agents - Make the existing command reload modified agents, not just new ones

Use Case

When developing custom agents for a project, I frequently iterate on:

  • Agent prompts
  • Tool access lists
  • Agent descriptions

Currently this requires a restart for each change, which breaks flow and loses context even with --continue.

Workaround

I've created a restart helper script (below), but native support would be much better:

# Prepare restart, exit, then resume
~/.claude/scripts/claude-restart.sh prepare "my-session" "$(pwd)"
# Exit Claude (Ctrl+C)
# Then run: claude --resume my-session

Thanks for considering this feature!

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗