agp-cli

🤖 AGP (Agentic Programming Project)

A standardized knowledge management system for AI-assisted development

AGP creates a persistent, context-rich development environment that works seamlessly across any AI programming assistant (ChatGPT, Claude, Cursor, etc.). By managing project knowledge through an isolated .agp directory as a Git submodule, AGP ensures consistent agentic behavior regardless of platform or session.

✨ Key Features

• 🧠 Persistent AI Memory: Knowledge accumulates over time, enabling any AI to pick up work instantly
• 👥 Multi-User Collaboration: Session management prevents file conflicts when multiple users work with AI
• 🔄 Session Continuity: Resume work seamlessly across conversations and platforms
• 📚 Auto-Generated Documentation: AI creates and maintains comprehensive project knowledge
• 🎯 Context-Aware: AI understands project structure, patterns, and conventions automatically

🚀 Quick Start

Installation

npm install -g agp-cli

Initialize a Project

# Initialize AGP in your project
agp init

# Start your session
agp start

Your First Session

Once initialized, any AI assistant can:

1. Read your project structure from .agp/architecture/
2. Understand implementation patterns from .agp/patterns/
3. Review session history from .agp/sessions/
4. Continue work without losing context

📋 Commands

Command	Description
agp init	Initialize AGP in your project with template setup
agp start	Start or resume your development session
agp push	Push session progress and knowledge to remote repository
agp connect <tool>	Configure AGP for AI tools (claude, cursor, chatgpt)

🏗️ How It Works

AGP creates a .agp directory structure that serves as persistent AI memory:

.agp/
├── instructions.md    # AI workflows and system rules
├── .config.json       # Local session configuration
├── architecture/      # Project structure and design decisions
├── patterns/          # Reusable implementation patterns
├── project/           # File-specific knowledge and context
└── sessions/          # User session tracking and history

The Magic

1. Knowledge Accumulation: Every file modification generates corresponding knowledge in .agp/project/
2. Pattern Recognition: Common solutions are extracted to .agp/patterns/ for reuse
3. Session Tracking: Multiple users can work safely without conflicts
4. Context Preservation: AI understands project history and conventions

🔧 Configuration

AGP uses a .config.json file (local-only) to track current session:

{
  "session": {
    "user": "alice",
    "current": ".agp/sessions/alice/index.md"
  }
}

🤝 Multi-User Workflow

AGP prevents collaboration conflicts through session management:

1. Each user has their own session directory
2. Active file locks prevent simultaneous edits
3. Session history enables seamless handoffs
4. Knowledge accumulates for the entire team

🎯 Perfect For

• AI-First Development: When you primarily work with AI assistants
• Knowledge-Heavy Projects: Complex codebases requiring context retention
• Team Collaboration: Multiple developers working with AI tools
• Long-Term Projects: Maintaining context across months or years
• Context Switching: Jumping between different features or areas

📖 Documentation

All documentation is auto-generated in your .agp directory after running agp init.

🤖 AI Integration

AGP works with any AI that can read files:

• Claude Code: Full integration with file reading capabilities
• ChatGPT: Upload .agp files for context
• Cursor: Built-in file understanding
• GitHub Copilot: Enhanced with project knowledge
• Any AI Tool: That supports file-based context

📄 License

MIT License - see LICENSE for details.

🙋‍♂️ Support

• Issues

---

Made with ❤️ for the AI development community