/inspector/nav#

Context Framework Note: Activated when debugging GoRouter navigation.

Triggers#

• Screen transition issues
• Route parameter issues
• Deep link debugging

MCP Tools#

nav_get_current_route#

Returns current route information.

nav_get_history#

Returns the navigation history stack.

nav_get_params#

Returns the current route's parameters.

nav_go#

Navigates to a specific path.

nav_push#

Pushes a new path onto the stack.

nav_pop#

Pops the current route.

nav_replace#

Replaces the current route.

nav_clear#

Clears the navigation stack.

Common Diagnostics#

Screen not transitioning#

1. nav_get_current_route - >   Check current location
2. nav_get_history - >   Check stack state
3. Review route definitions

Parameters not passed#

1. nav_get_params - >   Check current parameters
2. Review sending side code
3. Review receiving side parsing

Back navigation issues#

1. nav_get_history - >   Check stack depth
2. Test nav_pop
3. Review popUntil logic

Examples#

Check current route#

/inspector/nav current

Check navigation history#

/inspector/nav history

Test navigation to specific path#

/inspector/nav go /home

References#

• Detailed implementation: .claude/agents/flutter-inspector-nav.md
• Master inspector: .claude/commands/inspector.md