navigator

🥈Silver

Navigator extends Claude Code sessions beyond 20 exchanges, maintaining context for complex tasks. Ideal for developers and operations teams, it prevents session crashes and improves workflow continuity. Integrates with Python-based tools and workflows.

16770Updated 1mo ago

Intermediate30min to implementautomation

Saves ~120 min per use

Quick InstallView Source

git clone https://github.com/alekspetrov/navigator.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Start your task in a standard Claude Code session until you hit the 20-exchange limit or need to switch contexts.","tip":"Use descriptive comments in your code to maintain context for the Navigator skill."},{"step":"Copy the prompt template and replace [TASK_DESCRIPTION] with a summary of your current task, [OUTPUT_FILE_PATH] with where you want to save progress, and [VERIFICATION_COMMAND] with how you'll test the results.","tip":"Be specific about what 'maintain all prior context' means for your task (e.g., 'keep the same variable names', 'preserve the test cases')."},{"step":"Open a new Claude Code session and paste the customized prompt. The Navigator skill will automatically restore your previous state.","tip":"If you're using external tools (e.g., Git), ensure your session has access to the same repository state."},{"step":"Verify the output matches your expectations using the [VERIFICATION_COMMAND] you specified.","tip":"Add a comment like '# Navigator: Session continued' to mark where the session resumed."},{"step":"Continue working in the new session, and repeat the process when you hit the limit again.","tip":"For complex tasks, break them into smaller checkpoints (e.g., 'after implementing retry logic') to make Navigator transitions smoother."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/alekspetrov/navigator

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Continue this [TASK_DESCRIPTION] in a new Claude Code session using the Navigator skill. Maintain all prior context, variables, and progress. Ensure the output is saved to [OUTPUT_FILE_PATH] and verify the changes with [VERIFICATION_COMMAND].

Example Output

```
# Continuing from previous session: Refactoring the payment processing module
# Last action: Added validation for currency conversion in `payment_service.py`

### Context Summary:
- Project: E-commerce Platform v2.1
- Current file: `src/services/payment_service.py`
- Previous changes: Added `validate_currency()` function to handle dynamic currency conversion
- Pending task: Implement retry logic for failed payment gateway calls

### Current Implementation:
The `process_payment()` function now includes:
```python
def process_payment(amount, currency, user_id):
    if not validate_currency(amount, currency):
        raise ValueError("Invalid currency or amount")
    try:
        response = payment_gateway.charge(amount, currency)
        # TODO: Add retry logic here
        return response
    except PaymentGatewayError as e:
        log_error(f"Gateway failed: {e}")
        raise
```

### Next Steps:
1. Implement exponential backoff retry for `payment_gateway.charge()`
2. Add metrics tracking for retry attempts
3. Update unit tests in `tests/test_payment_service.py`

### Verification:
```bash
pytest tests/test_payment_service.py -v
python -c "from src.services.payment_service import process_payment; print(process_payment(100, 'USD', 'user123'))"
```

### Changes Saved To: src/services/payment_service.py
```