cognix 0.1.0

AI-powered CLI development assistant

Cognix

█▀▀ █▀█ █▀▀ █▄░█ █ ▀▄▀
█▄▄ █▄█ █▄█ █░▀█ █ █░█

Cognix — Augmented AI Development Partner for CLI
Persistent Sessions, Long-Term Memory, Multi-Model Support, and Full-Pipeline Development.
Build smarter, faster, and without context loss.

Quick Start • Demo • Features • Commands

---

🎯 12-Second Magic

Cognix is the only AI coding Partner that:

• 💾 Session Restoration: Resume interrupted work completely
• ⚡ Structured Workflow: Think → Plan → Write
• 🎨 Practical Results: Generate beautiful GUI apps instantly
• 🧠 Persistent Memory: Remember entire projects across sessions

"Once you have an idea, it's already complete."

---

🎬 See It In Action

https://github.com/cognix-dev/cognix/assets/226239127/478856788-94577806-5a80-4deb-ae58-c699c43efd3c

12-second demo: Session restoration → /write → Beautiful neon green clock app

Quick Demo (12 seconds)

# 0-1 seconds: Start Cognix
cognix

# 1-3 seconds: Session restoration
Would you like to restore the previous session? [y/N]: y
✅ Session restored successfully!
🔄 Workflow state restored!
   Goal: Brief: big bright green clock popup window bold digits
   Progress: ✅ Think → ✅ Plan → ⏳ Write

# 3-8 seconds: Code generation
cognix> /write --file clock.py
✨ Writing implementation for: Brief: big bright green clock popup window bold digits
   Target file: clock.py
   Target language: python (from .py)

# 8-10 seconds: Beautiful neon green clock appears
Save generated code to clock.py? [y/N] y
✅ Code saved to: clock.py

What you just saw:

1. 💾 Workflow Restoration: AI remembers your thinking process across sessions
2. ⚡ Instant Code Generation: From plan to working GUI in seconds
3. 🎨 Beautiful Results: Functional neon green digital clock with #00FF00 perfection
4. 🚀 Complete Pipeline: Think → Plan → Write → Deploy in one session

Try It Yourself

# Step 1: Start your thinking
cognix> /think "Brief: bright green digital clock GUI"

# Step 2: Plan implementation  
cognix> /plan

# Step 3: Generate code
cognix> /write --file my_clock.py

# Step 4: Exit and run
cognix> exit
python my_clock.py  # → Beautiful clock appears!

---

🚀 Quick Start

Installation

Recommended (isolated):

pipx install cognix

Alternative:

pip install cognix

Setup (2 minutes)

# 1. Get your API key from Anthropic or OpenAI
# https://console.anthropic.com/ or https://platform.openai.com/

# 2. Create .env file
echo "ANTHROPIC_API_KEY=your_api_key_here" > .env
echo "OPENAI_API_KEY=your_api_key_here" >> .env

# 3. Start Cognix
cognix

Your First Workflow (30 seconds)

cognix> /think "Create a REST API for user authentication"
# 🤔 AI analyzes your requirements...

cognix> /plan
# 📋 AI creates detailed implementation plan...

cognix> /write --file auth_api.py
# ✍️ AI generates production-ready code...

That's it! Your API is ready to use.

---

📋 Commands

Core Workflow

Command	Description	Example
/think "<goal>"	AI analyzes your problem	/think "API rate limiting"
/plan	Creates implementation strategy	/plan
/write [--file path]	Generates production code	/write --file api.py

Help & Information

Command	Description	Example
/help	Show all commands	/help
/model	Show current model & options	/model
/workflow-status	Check current progress	/workflow-status
/status	Show current config/model	/status
/memory	Inspect or export memory	/memory export

AI Model Management

Command	Description	Example
/model <name>	Switch AI models instantly	/model gpt-4o

File Operations

Command	Description	Example
/edit <file>	AI-assisted editing	/edit src/main.py
/fix <file>	Auto-fix bugs	/fix api.py --function auth
/review [dir]	Code analysis	/review src/
/diff	Show changes before applying	/diff
/apply	Apply generated patch safely	/apply
/backup	Manage backups/restore	/backup restore

Session Management

Command	Description	Example
/save-session <name>	Save your work	/save-session "auth-system"
/resume <name>	Resume previous work	/resume "auth-system"
/list_sessions	List saved sessions	/list_sessions
/session_info	Show current session meta	/session_info
/save_session <name>	Save current session	/save_session mywork
/resume <name>	Restore a saved session	/resume mywork

Workflow Control

Command	Description	Example
/clear-workflow	Start fresh	/clear-workflow

---

🌟 Key Features

🔄 Multi-AI Powerhouse

cognix> /think "Build a todo app"
# Using Claude-4: Detailed, enterprise-focused analysis

cognix> /model gpt-4o
✅ Switched to: gpt-4o

cognix> /think "Build a todo app"  
# Using GPT-4o: Creative, modern, action-oriented approach

Compare results instantly. Choose the best AI for each task.

🧠 True Session Persistence

# Yesterday
cognix> /think "E-commerce platform architecture"
cognix> /plan
# Work interrupted...

# Today
cognix
🔄 Workflow state restored!
Goal: E-commerce platform architecture  
Progress: ✅ Think → ✅ Plan → ⏳ Write

cognix> /write --file platform.py
# Continue exactly where you left off!

⚡ Lightning-Fast Development

# Generate production-ready GUI apps in seconds
cognix> /think "Brief: neon green clock GUI"
cognix> /plan  
cognix> /write --file clock.py
# → Beautiful tkinter app with #00FF00 fluorescent green digits!

Perfect for rapid prototyping and instant visual results.

⚡ Intelligent Context Awareness

• 📁 Auto-scans your project structure
• 🧠 Remembers all previous conversations
• 🎯 Adapts suggestions to your codebase
• 🔄 Maintains context across sessions

---

💡 Real Usage Examples

Scenario 1: Feature Development

cognix> /think "Add OAuth2 authentication to my Express.js API"

💭 Analysis Result:
**1) What needs to be built:** OAuth2 flow with JWT tokens, middleware for route protection, 
and integration with popular providers (Google, GitHub, etc.)
**2) Key challenges:** Token validation, refresh logic, and secure session management
**3) Success approach:** Use passport.js ecosystem, implement proper error handling, 
and add comprehensive testing for auth flows

cognix> /plan

📋 Implementation Plan:
- Setup & core logic: Install passport, passport-jwt, configure strategies for Google/GitHub OAuth2...
- Security implementation: JWT signing/validation, refresh token rotation, rate limiting...
- Testing & deployment: Unit tests for auth middleware, integration tests for OAuth flows...

cognix> /write --file auth/oauth.js
# Generates complete OAuth2 implementation

Scenario 2: AI Model Comparison

# Claude-4 approach (detailed, enterprise-focused)
cognix> /think "Database caching strategy"
→ Comprehensive analysis with Redis, Memcached comparison, 
  enterprise concerns, compliance considerations

# Switch to GPT-4o for creative alternatives  
cognix> /model gpt-4o
cognix> /think "Database caching strategy"  
→ Modern approach with edge caching, CDN integration,
  serverless caching solutions

# Choose the best elements from both!

Scenario 3: Session Restoration

# After weekend break
cognix
📋 Previous session found!
   Last updated: 2025-08-09T18:42:57
   Entries: 15
   Model: claude-sonnet-4-20250514

Would you like to restore the previous session? [y/N]: y
✅ Session restored successfully!
🔄 Workflow state restored!
   Goal: Microservices architecture design
   Progress: ✅ Think → ✅ Plan → ⏳ Write

# Continue immediately where you left off
cognix> /write --file services/user-service.py

Scenario 4: Rapid GUI Prototyping

# 12-second workflow for visual applications
cognix> /think "Brief: desktop calculator with dark theme"
cognix> /plan
cognix> /write --file calculator.py

# Result: Complete GUI calculator ready to use
python calculator.py  # → Professional calculator app launches

---

🎯 Supported AI Models

Claude 4 Series (Anthropic)

• claude-opus-4-20250514 - Most capable, complex reasoning
• claude-sonnet-4-20250514 - Balanced performance & speed

GPT-4o Series (OpenAI)

• gpt-4o - Latest model, highly creative
• gpt-4o-mini - Fast responses, cost-effective

Legacy Support

• claude-3-5-sonnet-20241022
• claude-3-7-sonnet-20250219

Switch between any model instantly: /model gpt-4o

---

⚙️ Configuration & Customization

📁 Data Storage & Privacy

Cognix stores local data under your home directory:

• ~/.cognix/config.json — user configuration
• ~/.cognix/sessions/ — saved sessions & autosave
• ~/.cognix/memory/memory.json — long‑term memory

All files are local to your machine. You can delete them anytime.

Default Config (~/.cognix/config.json)

{
  "model": "claude-sonnet-4-20250514",
  "temperature": 0.7,
  "max_tokens": 4000,
  "auto_backup": true,
  "stream_responses": true,
  "typewriter_effect": false
}

Environment Variables

# API Keys (Required)
ANTHROPIC_API_KEY=your_anthropic_key
OPENAI_API_KEY=your_openai_key

# Optional settings  
COGNIX_DEBUG=true
DEFAULT_MODEL=gpt-4o
COGNIX_AUTO_SAVE=true

System Requirements

• Python: 3.8 or higher
• OS: Windows 10+, macOS 10.15+, Linux
• Memory: 512MB minimum recommended
• Internet: Required for API connections

---

🏆 Why Choose Cognix?

vs. GitHub Copilot

Feature	Cognix	Copilot
Multi-AI Support	✅ GPT-4o + Claude-4	❌ OpenAI only
Session Persistence	✅ Full project memory	❌ No memory
Workflow Structure	✅ Think→Plan→Write	❌ Code completion only
CLI Integration	✅ Native terminal	❌ Editor-dependent

vs. ChatGPT/Claude Web

Feature	Cognix	Web Interfaces
Development Integration	✅ Direct file operations	❌ Copy-paste workflow
Project Context	✅ Full codebase awareness	❌ Limited context
AI Model Switching	✅ Instant switching	❌ Separate applications
Session Management	✅ Auto-save everything	❌ Manual management

vs. Other AI Coding Tools

• 🧠 Memory Persistence: Only Cognix remembers everything across sessions
• 🔄 Multi-AI: Compare approaches from different models instantly
• ⚡ Structured Workflow: Think→Plan→Write methodology
• 🎯 State Restoration: Resume work exactly where you left off

---

🚀 Project-Specific Examples

Web Development

cognix> /think "Full-stack blog platform with Next.js"
cognix> /plan
cognix> /write --file blog-platform.js

Data Science

cognix> /think "Analyze customer churn with machine learning"
cognix> /plan  
cognix> /write --file churn_analysis.py

DevOps

cognix> /think "Docker containerization for my Python app"
cognix> /plan
cognix> /write --file Dockerfile

Mobile Development

cognix> /think "React Native app with offline sync"
cognix> /plan
cognix> /write --file OfflineSync.js

---

🛠️ Advanced Features

Constraint Detection

cognix> /think "Todo app - brief"
🎯 Detected constraints: brief format
💭 Analysis Result:
**1) What needs to be built:** Basic CRUD operations...
**2) Key challenges:** Data persistence and user experience...  
**3) Success approach:** Start with MVP featuring essential functions...

Intelligent File Operations

# Edit with AI assistance
cognix> /edit src/api.py
📝 Editing: src/api.py
What changes would you like to make? Add rate limiting


🤖 Generating suggestions...
💡 Suggestion: I'll add Express rate limiting middleware...

# Auto-fix specific functions
cognix> /fix utils.py --function calculate_total
🔧 Analyzing function: calculate_total
✅ Fixed: Added null checking and proper error handling

Project-Aware Conversations

cognix> How can I improve the performance of my React components?

# AI automatically analyzes your React project structure
🧠 Analyzing your React project...
📁 Found: 15 components, 3 hooks, 2 contexts

💡 Specific recommendations for your codebase:
1. UserProfile.jsx: Consider React.memo for expensive renders
2. DataTable.jsx: Implement virtualization for large datasets  
3. Global state: Your Redux store could benefit from RTK Query

---

🤝 Contributing

We welcome contributions! Here's how to get started:

Development Setup

git clone https://github.com/cognix-dev/cognix.git
cd cognix
pip install -e ".[dev]"

Running Tests

pytest tests/

Code Style

black cognix/
flake8 cognix/

Contribution Guidelines

• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Proposals: GitHub Discussions
• 🔀 Pull Requests: Contributing Guide

---

🧰 Troubleshooting

• No LLM providers available → Set ANTHROPIC_API_KEY or OPENAI_API_KEY in your .env, then restart Cognix.
• Patch apply failed → Restore the last backup with /backup restore.

📄 License

MIT License - see LICENSE file for details.

---

🌟 Roadmap

v0.2.0 - Memory Management & Code Enhancement

• 📝 Individual memory entry deletion
• 🗂️ Automatic memory archiving
• 📊 Memory size management and cleanup
• 🎨 AI code enhancement (/refactor, /lint)
• ⚡ Improved streaming output

v0.3.0 - Advanced Development Features

• 🎯 Target file/function specification (@filename, #function)
• 🏃 File execution capabilities (/run)
• 📱 Browser-based GUI (beta)
• 🔍 Advanced code analysis features

v0.4.0 - Team Collaboration

• 👥 Shared sessions between team members
• 📋 Code review workflows
• 🔗 Basic GitHub/GitLab integration

v0.5.0 - Enterprise

• 🏢 Self-hosted deployment options
• 🔒 Advanced security features
• 📊 Usage analytics and metrics

---

💬 Support

Need Help?

• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Requests: GitHub Discussions

Stay Updated

• 🐦 X: @Cognix_dev

---

🧠 Cognix - Where AI meets intelligent development workflows

Made with ❤️ by Individual Developer

⭐ Star on GitHub • 🚀 Get Started

---