Astropath

Astropath is a CLI tool designed to orchestrate local AI agents for software development workflows, enabling human-in-the-loop coordination through specialized agent roles and markdown-based context sharing.

Features & Capabilities

Specialized Agent Roles: Choose from different agent types, each optimized for specific development tasks:

• Analyst: Analyzes code structure, identifies patterns, and provides insights
• Developer: Implements features, fixes bugs, and writes code
• Explorer: Navigates and documents codebase structure and functionality
• Reviewer: Performs code reviews and suggests improvements

Human-in-the-Loop Workflow: Agents coordinate through ASTROPATH.md files that maintain context between execution steps, allowing you to guide and review the process at each stage.

Git-Safe Operations: Agents can create git branches and modify code in feature branches, but never directly modify the main branch, ensuring your codebase remains protected.

Minimal Dependencies: Built with Go standard library and Cobra CLI framework, keeping the tool lightweight and focused.

Command-Based Interface: Execute agents individually or as part of multi-step workflows using dedicated commands for each agent type.

Usage Examples

Initialize a Project

# Set up Astropath in your project directory
astropath init

Explore Your Codebase

# Have the Explorer agent analyze and document your project structure
astropath explore

Analyze Specific Code

# Use the Analyst to read the issue detailed in ASTROPATH.md and generate a solution proposal
astropath analyze

Implement New Features

# Let the Developer agent implement functionality based on requirements
astropath develop

Code Review Process

# Get comprehensive code review feedback
astropath review

Multi-Step Workflow

# Use pipeline for coordinated multi-agent execution. 
# Pipeline will run analyst -> developer -> reviewer agents with waits after each step providing a way for human-in-the-loop refinement of requirements.
astropath pipeline 

Raw Claude Interaction

# Direct interaction with Claude for custom tasks
astropath raw "Help me debug this specific function"

Each command creates or updates the ASTROPATH.md file with context, allowing you to review progress and provide guidance between steps.

To-Fix list

• Add a 'tester' AI agent role

• Improve the prompts so Claude:

  • Thinks less in useless stuff
  • Writes less words but more important ones

• Improve role branches management

  • If branch is specified -> tell the agent to use that
  • If no branch is specified but current branch is not main -> use that one
  • If no branch is specified and current branch is main -> Checkout to a new one

• Add some sort of logging to Claude usage (tokens, costs, queries, whatever)

• Idea: different ASTROPATH.md files to track different tasks / executions (or attach them to the branches somehow to implement some tracing)

Created By

• Fynardo
• Claude itself