🚀 Astro Developer - AI-Powered CLI Assistant

⚠️ ALPHA RELEASE: This is an early version. Features and APIs can change at any time. Report issues.

✨ What is Astro Developer?

Astro Developer is an AI-powered CLI assistant that helps you read, edit, analyze, and debug code. It provides an interactive chat interface with intelligent tools for working with your codebase.

Perfect for:

• 🎯 Quick code reviews
• 🐛 Debugging assistance
• 📚 Understanding codebases
• 🔧 Refactoring code
• 📊 Analyzing project metrics
• 💡 Learning best practices

🎯 Features

Core Capabilities

• 📖 Read Files - View files with syntax highlighting, line range filtering
• 🔍 Search - Find patterns and text across your codebase
• ✏️ Edit Files - Modify code with AI assistance and approval control
• 🔄 Find & Replace - Bulk text replacement with confirmation
• 📊 Analyze - Get codebase statistics and complexity metrics

Advanced Features

• 💬 Multi-turn Conversations - Full context preservation across chat sessions
• 🤔 AI Reasoning - Toggle visibility of AI thinking process
• ⚡ Response Interruption - Press ESC to stop long-running responses instantly
• 🎯 Auto-approve Edits - Skip approval prompts for trusted workflows
• 🔄 Multiple Models - Switch between ModelA 9 Nano and ModelA 9
• ⚙️ Per-Directory Config - Settings stored in .astrodeveloper folder
• 🎨 Professional UI - Beautiful purple-themed terminal interface

🚀 Quick Start

1. Install

npm install -g @novasuite/astro-developer

2. Set Up API Credentials

This is required before first use. See SETUP_GUIDE.md for detailed instructions.

Quick Setup:

# Copy the example environment file
cp .env.example .env

# Edit .env and add your API credentials
# ASTRO_MODELA_9_NANO_URL=your-endpoint
# ASTRO_MODELA_9_NANO_KEY=your-api-key
# ASTRO_MODELA_9_URL=your-endpoint
# ASTRO_MODELA_9_KEY=your-api-key

Or set environment variables:

export ASTRO_MODELA_9_NANO_URL="your-endpoint"
export ASTRO_MODELA_9_NANO_KEY="your-api-key"
export ASTRO_MODELA_9_URL="your-endpoint"
export ASTRO_MODELA_9_KEY="your-api-key"

3. Configure App Settings

astro-dev setup

Creates .astrodeveloper/config.json with your preferences (model, auto-approve, etc).

4. Launch

astro-dev

5. Chat

You: "How can I optimize this component?"
Astro: [AI response with analysis and suggestions]

You: /model
Astro: [Show available AI models to switch between]

You: /status
Astro: [Show current configuration]

📋 Available Commands

Interaction

Configuration

Utilities

⌨️ Keyboard Shortcuts

⚙️ Configuration

Settings are stored in .astrodeveloper/config.json in your project directory.

Default Configuration

{
  "model": "modela-9-nano",
  "autoApproveEdits": false,
  "showConsideration": false,
  "conversationHistoryLimit": 20
}

Configuration Options

Reconfigure

astro-dev setup

🤖 AI Models

ModelA 9 Nano (Default)

• ✅ Fast response times
• ✅ Perfect for quick tasks and reviews
• ✅ Optimized for terminal usage
• ✅ Lower latency

ModelA 9

• ✅ More powerful analysis
• ✅ Better for complex refactoring
• ✅ Deeper understanding
• ✅ Larger context window

Switch anytime with:

/model modela-9
/model modela-9-nano

⬆️ Updates

Astro Developer includes an automatic update system that checks for new versions:

Auto-Update Notification

• Updates are checked every 24 hours (cached)
• When an update is available, you'll see a notification on startup
• Use /update command to check and install updates immediately

Updating

# Via the CLI
astro-dev update

# Or install directly
npm install -g astro-developer@latest

# Via /update command in chat
/update

Force Update Check

To bypass the 24-hour cache and check immediately:

astro-dev update --force

🛠️ AI Tools

The assistant has access to intelligent tools for code manipulation:

read

Read file contents with optional line ranges

<tool:read params='{"file":"src/index.js"}'>
<tool:read params='{"file":"src/app.js","lines":"1-50"}'>

search

Find patterns across your codebase

<tool:search params='{"query":"TODO","fileType":"js"}'>

edit

Modify files with automatic approval workflow

<tool:edit params='{"file":"src/app.js","oldCode":"const x = 1;","newCode":"const x = 2;"}'>

find_replace

Bulk text replacement across files

<tool:find_replace params='{"find":"console.log","replace":"logger.info","fileType":"js"}'>

analyze

Get codebase metrics and statistics

<tool:analyze params='{"path":"src","fileType":"js"}'>

💡 Examples

Code Review

"Can you review the authentication logic in src/auth.js
and suggest improvements?"

Debugging

"I'm getting TypeError: Cannot read property of undefined
in my component. Can you help me debug it?"

Refactoring

"Refactor this class component to use React hooks.
Use the read tool to check the current implementation first."

Learning

/explain closure
/explain async/await
/practices typescript

Analysis

"Analyze the codebase structure and tell me about
the complexity and potential issues."

Quick Changes

/auto-approve
"Replace all console.log with logger.info in the src directory"

🔒 Approval System

Manual Approval (Default)

See detailed previews before edits are applied:

📝 Edit Approval Required

File: src/app.js

─ Removing:
│ const x = 1;

+ Adding:
│ const x = 2;

➤ Approve this edit? (Y/n)

Auto-Approval

For faster workflow:

/auto-approve

Or configure during setup:

astro-dev setup
# Select "Yes" for auto-approval

⚡ Performance Tips

1. Use line ranges for large files

   <tool:read params='{"file":"large_file.js","lines":"1-100"}'>

2. Limit conversation history for faster context

   • Configure in setup: 5-10 messages for quick sessions

3. Enable auto-approve for trusted workflows

   /auto-approve

4. Use ModelA 9 Nano for quick tasks

   • Faster responses, perfect for routine tasks

📦 System Requirements

• Node.js: 14.0.0 or higher
• npm: 6.0.0 or higher
• Disk Space: ~50MB
• Internet: Required for AI features

🐛 Troubleshooting

Configuration not loading

Verify config file exists:

cat .astrodeveloper/config.json

Model not found

Check available models:

/model

Setup issues

Reconfigure from scratch:

astro-dev setup

Clear chat history

/clear

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

CC BY-NC-SA 4.0 - See LICENSE for details

🆘 Support & Bug Reports

Report Issues

Since Astro Developer is in ALPHA, we need your feedback!

• Report bugs: novasuite.one/report
• GitHub Issues: Report issues
• Discussions: Ask questions
• In-App: Run /readme for quick start guide

What to Include in Bug Reports

• Your astro-dev version (astro-dev --version)
• Operating system and Node.js version
• Steps to reproduce the issue
• Expected vs actual behavior

🎉 Credits

Built with ❤️ for developers who love their terminal

Built with:

• Commander.js - CLI framework
• Chalk - Terminal styling
• Inquirer.js - Interactive prompts
• Ora - Spinners and progress