agentic-coder

Agentic Coder

🤖 AI-powered development assistant that internalizes and works with your project files using Google Gemini

Agentic Coder is a powerful CLI tool that can be installed globally via npm and work seamlessly with any external project by internalizing the project files and providing an AI-powered development assistant.

🚀 Installation

Global Installation (Recommended)

npm install -g agentic-coder

Local Development

git clone <repo-url>
cd agentic-coder
npm install
npm start

⚙️ Configuration

Before using agentic-coder, you need to configure your Gemini API key:

Environment Variables

Set these environment variables or add them to your shell profile:

export GEMINI_API_KEY="your-gemini-api-key-here"
export MODEL_NAME="gemini-1.5-flash"  # optional, defaults to gemini-1.5-flash
export PORT="3001"                     # optional, defaults to 3001

Global Configuration

The first time you run agentic-coder, it will create a global configuration file at ~/.agentic-coder/config.json.

📋 Usage

Quick Start

• Navigate to any project directory
• Run agentic-coder
• The tool will detect your project type and offer to internalize it
• Start chatting with the AI about your code!

Commands

# Start agentic-coder in current directory
agentic-coder

# Initialize agentic-coder in a project (optional)
agentic-coder --init

# Show current configuration
agentic-coder --config

# Show help
agentic-coder --help

🎯 Features

🎯 NEW: Smart File & Folder Autocomplete System ⭐

• Intelligent Suggestions: Type :suggest @cli to find client.js, cli/, and related files
• Prevents Wrong File Creation: No more accidentally creating client.js when clients.js exists
• Pattern Matching: Use @*.js, @src/*, @* for advanced file discovery
• Auto-Detection: System suggests files when you type @ references in messages
• Smart Scoring: Exact matches, fuzzy matching, and typo tolerance

🔄 Project Internalization

• Automatically detects project types (Node.js, Python, Rust, Go, Java)
• Copies project files into secure session workspace
• Respects .gitignore patterns and common ignore rules
• Works with any project structure

💬 Intelligent Session Management

• Enhanced Session Selection: No longer dumps all sessions at once
• Search by Name: Type session names instead of just selecting by number
• Multiple Input Options: Numbers, names, or 'new' for new sessions
• Recent Sessions: Shows only recent sessions by default

🛠️ AI-Powered Development

• File and directory CRUD operations
• Code generation and modification
• Project analysis and suggestions
• Conversation persistence across sessions
• Context-aware responses

🎛️ CLI Interface

Interactive commands within the CLI:

• :suggest @partial - NEW: Find files/folders matching partial name
• :auto @utils - NEW: Quick file suggestions (short form)
• :autocomplete @src/ - NEW: List directory contents
• help - NEW: Show autocomplete commands
• :sessions - Enhanced session selector with search
• :model - Configure AI model settings per session
• exit - Close the application

📂 Project Types Supported

• Node.js (package.json)
• Python (requirements.txt)
• Rust (Cargo.toml)
• Go (go.mod)
• Java (pom.xml)
• Git repositories (.git folder)

🏗️ Project Structure

When you run agentic-coder in a project directory, it:

• Detects project type(s)
• Internalizes the project by copying relevant files
• Creates a session workspace with your project files
• Ignores common build artifacts and dependencies
• Preserves your original project untouched

Example Workflow

# Navigate to your project
cd /path/to/my-awesome-project

# Start agentic-coder
agentic-coder
# Output: 🔍 Detected project types: nodejs, git
# Output: Internalizing project from: /path/to/my-awesome-project
# Output: ✅ Project internalized successfully
# Output: 🚀 Session: morning-dev-session

# Start coding with AI - now with smart file suggestions!
[morning-dev-session]> :suggest @client
# 📋 File Suggestions:
#   1. @clients.js (95%)
#   2. @clientService.js (88%)
#   3. @api/client.js (75%)

[morning-dev-session]> create a new React component in @components/

📋 Session Management

Enhanced Session Selection

• Recent Sessions: Shows only recent sessions initially
• Search Capability: Type session names to find and select
• Multiple Options:
  • Type a number (1-5) to select recent session
  • Type a session name to search and select
  • Type 'new' to create new session
  • Press Enter to use current session

Interactive Session Selector (:sessions command)

• Search and Filter: Find sessions by typing names
• Visual Indicators: Shows current session clearly
• Full List Access: Type 'all' to see all sessions
• Keyboard Navigation: Easy selection with numbers or names

⚠️ Ignored Files

The following patterns are automatically ignored during internalization:

• node_modules/
• .git/
• dist/, build/, target/
• .env files
• Log files (*.log)
• IDE files (.idea/, .vscode/)
• Cache directories
• Any patterns from your project's .gitignore

🔧 Advanced Configuration

Per-Project Configuration

Run agentic-coder --init in a project to create a .agentic-coder.json configuration file:

{
  "projectRoot": "/path/to/project",
  "projectTypes": ["nodejs", "git"],
  "createdAt": "2024-01-01T00:00:00.000Z",
  "settings": {
    "autoInternalize": true,
    "syncOnStart": true
  }
}

Global Configuration Location

• Config: ~/.agentic-coder/config.json
• Sessions: ~/.agentic-coder/sessions/
• Logs: ~/.agentic-coder/logs/

🤝 Development

Local Development Setup

git clone <repo-url>
cd agentic-coder
npm install

# Set environment variables
export GEMINI_API_KEY="your-api-key"

# Run in development mode
npm run dev

Testing

npm test

Publishing

npm version patch|minor|major
npm publish

🎯 Quick Start with Autocomplete

# Start agentic-coder
agentic-coder

# Try the new autocomplete features:
:suggest @cli          # Find files matching "cli"
:auto @utils           # Find utils files
:suggest @package      # Find package.json, package-lock.json
:suggest @*.js         # Find all JavaScript files
help                   # Show all commands

# Test interactively:
node demo-autocomplete.js

# Run test suite:
node test-autocomplete.js

📚 Documentation:

• Quick Reference - Get started in 30 seconds
• Complete Guide - Detailed autocomplete documentation
• Release Notes - What's new in this update

📝 License

MIT License - see LICENSE file for details.

🐛 Issues and Support

Please report issues on the GitHub issues page.

Made with ❤️ for developers who want AI assistance without losing control of their code.