🧠 noidea

Git assistant with AI commit messages and sassy feedback

noidea is a Git companion that makes your commits better and funnier:

• Get smart commit messages based on your changes
• Receive sassy feedback from a judgmental Moai after each commit
• Analyze your Git history for insights and patterns
• Seamless integration with Git workflows

• 🧠 AI-Powered Suggestions - Get professional commit messages based on your staged changes
• 🗿 Moai Feedback - Receive witty, personalized feedback on your commits
• 📊 Git Insights - Track coding patterns and get weekly summaries
• 🎭 Multiple Personalities - Choose from several AI personalities for feedback
• 🔒 Secure API Key Management - Keep your AI provider keys safe
• 🚀 GitHub Integration - Manage GitHub releases with AI-enhanced release notes and smart workflow awareness

Get up and running in seconds—no complex config needed.

1. Install:

   cd /path/to/noidea  # Or clone: git clone <repo> noidea && cd noidea
   ./install.sh  # Builds binary, sets up ~/.noidea/config (AI disabled by default)

2. Initialize in a Repo (the magic happens here):

   cd your-project
   noidea init  # Installs hooks: suggestions on commit, Moai faces after

3. Try It (your favorite flow):

   git add .
   git commit  # No -m: Opens editor with AI/local suggestion pre-filled!
   # Edit/save to commit. Moai face appears after (fun, no text by default).

Defaults Explained:

• Suggestions: Always on after init—tries local first (fast, no API), falls back from AI if enabled.
• Moai Faces: Always show after commits (random/mood mode, no text feedback to keep it light).
• AI Features: Disabled by default (no API key needed). Enable with noidea config --init for smarter suggestions/feedback.

For full AI: Set your xAI/OpenAI key during install or later. See Configuration.

• Seamless Editor Integration: git commit auto-suggests messages in your editor—edit and go (no extra commands).
• Fun Without Overload: Moai judges your commits with faces (opt-in text feedback).
• Smart Defaults: Works out-of-box; AI optional for power users.
• Git-First: Hooks respect your workflow—no CI bloat.

# Stage your changes
git add .

# Commit (noidea will suggest a message)
git commit

This will open your default editor with the suggested commit message. Save and close to approve and commit.

For AI-powered features, add your API key:

1. Securely store your API key (recommended):

   noidea config apikey

2. Add to environment (alternative):

   export XAI_API_KEY=your_api_key_here

3. Configure interactively:

   noidea config --init

See API Key Management for secure storage details.

noidea provides seamless GitHub integration for managing releases and generating release notes:

1. Set up GitHub integration:

   # Authenticate with GitHub
   noidea github auth
   
   # Install GitHub hooks (optional)
   noidea github hook-install

2. Generate enhanced release notes:

   # Generate release notes for the latest tag
   noidea github release notes
   
   # Wait for GitHub workflows to complete before generating notes
   noidea github release notes --wait-for-workflows
   
   # Generate notes for a specific tag
   noidea github release notes --tag=v1.2.3

3. Automatic version management with the version script:

   # Bump patch version (0.0.x)
   ./scripts/version.sh patch
   
   # Bump minor version (0.x.0)
   ./scripts/version.sh minor

The release notes generator enhances GitHub's standard release notes with AI-powered descriptions while preserving GitHub's changelog with commit links.

Run noidea --help for more information.

noidea has several AI personalities for feedback:

• Snarky Code Reviewer - Witty, sarcastic feedback
• Supportive Mentor - Encouraging, positive feedback
• Git Expert - Technical, professional feedback
• Motivational Speaker - Energetic enthusiasm

# Use a specific personality
noidea moai --personality supportive_mentor

easily setup your own personality or edit existing ones!

Create a ~/.noidea/config.json file:

{
  "llm": {
    "enabled": true,
    "provider": "xai",
    "api_key": "",
    "model": "grok-4-fast-reasoning",
    "temperature": 0.7
  },
  "moai": {
    "use_lint": false,
    "faces_mode": "random",
    "personality": "snarky_reviewer",
    "personality_file": "~/.noidea/personalities.toml"
  }
}

Contributions are welcome! Whether you have ideas for new features, have encountered bugs, or want to improve documentation, we'd love your input.

Please feel free to submit an issue or join the discussions. Each contribution helps us make noidea better.

Because Git is too serious. Coding is chaos. Let's embrace it.

This tool won't improve your Git hygiene, but it will make it more entertaining.

This project is distributed under the MIT License. See the LICENSE file for details.