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:
- Exiting Claude Code
- Restarting with
claude --continue
- The
/agentscommand 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:
/reloadcommand - Reload all agents, hooks, and plugins from disk/reload agents- Reload just agent definitions- File watching - Automatically detect changes to
.claude/agents/*.mdfiles and reload - 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!
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗