Roadmap

Planned development roadmap for HelixCommit from the current version through v2.0

v1.3.0 - Enhanced Commands (Q1 2026)

Theme: Command Polish & User Experience

Planned Features

• Streaming AI output (character-by-character display)
• Interactive commit selection for changelog generation
• Copy-to-clipboard support (--copy flag)
• Enhanced diff viewer with line-by-line navigation
• Commit comparison view (side-by-side)
• Export search results to various formats

Technical Improvements

• Improved caching for faster repeated operations
• Better handling of large repositories
• Memory optimization for big diffs

---

v1.4.0 - Monorepo Restructure (Q2 2026)

Theme: Architecture & Maintainability

Planned Changes

• Split into helixcommit-core and helixcommit-cli packages
• Define clean public API for core library
• Enable programmatic usage without CLI dependencies
• Separate PyPI packages for core and CLI

New Package Structure

helixcommit/
  packages/
    core/                    # helixcommit-core
      src/helixcommit_core/
        git/                 # Git operations
        ai/                  # AI summarization
        changelog/           # Changelog building
        models.py
        config.py
      pyproject.toml
    cli/                     # helixcommit-cli
      src/helixcommit_cli/
        commands/
        ui/
        themes/
      pyproject.toml
  tests/
  docs/

---

v1.5.0 - Advanced Interactivity (Q2 2026)

Theme: Interactive Experience

Planned Features

• Multi-select commits with checkbox interface
• Vim-like keyboard navigation
• Fuzzy search/filter within selections
• Branch name autocompletion
• Commit type autocompletion
• Author name autocompletion from history

New Commands

• helixcommit select - Interactive commit selector
• helixcommit filter - Advanced filtering UI

---

v1.6.0 - Configuration & Setup (Q3 2026)

Theme: Developer Onboarding

Planned Features

• helixcommit init - Guided setup wizard
• helixcommit config - Interactive config editor
• helixcommit config show - Display current configuration
• helixcommit config set <key> <value> - Set config values
• Project templates for different workflows
• Team configuration sharing

Configuration Enhancements

• Per-directory configuration overrides
• Environment-specific configs (dev, staging, prod)
• Configuration validation and linting

---

v1.7.0 - Streaming AI (Q3 2026)

Theme: Real-time AI Experience

Planned Features

• Stream AI summaries character-by-character
• Live-updating progress for batch operations
• Cancelable AI operations with Ctrl+C
• Parallel AI summarization for speed
• AI response caching with TTL
• Retry logic with exponential backoff UI

AI Enhancements

• Support for additional AI providers (Anthropic, Ollama)
• Custom prompt templates
• AI tone/style configuration
• Summary length control

---

v1.8.0 - Developer Experience (Q4 2026)

Theme: Workflow Integration

Planned Features

• Clipboard integration (--copy flag)
• helixcommit hooks install - Git hooks setup
• helixcommit hooks uninstall - Remove hooks
• Pre-commit hook for message validation
• Post-tag hook for automatic changelog
• CI/CD integration improvements

Integration Features

• GitHub Actions workflow generator
• GitLab CI template generator
• Slack/Discord webhook notifications
• JIRA/Linear issue linking

---

v1.9.0 - TUI Preview (Q4 2026)

Theme: Full-screen Terminal UI

Planned Features

• helixcommit tui - Launch full-screen interface
• Split-pane layout (commits | details | preview)
• Keyboard-driven navigation
• Real-time filtering
• Mouse support

TUI Components

• Commit list panel with scrolling
• Diff viewer panel with syntax highlighting
• Changelog preview panel
• Status bar with context info
• Command palette (Ctrl+P)

---

v2.0.0 - Full TUI & Plugins (Q1 2027)

Theme: Extensibility & Polish

Major Features

• Complete Textual-based TUI application
• Plugin system for custom formatters
• Plugin system for AI providers
• Theme marketplace/sharing
• Multi-repository support

TUI Enhancements

• Side-by-side diff viewing
• Commit graph visualization
• Branch comparison view
• Merge conflict helper
• Stash management

Plugin System Example

# Example plugin interface
class HelixCommitPlugin:
    name: str
    version: str
    
    def on_changelog_build(self, changelog: Changelog) -> Changelog:
        """Hook called after changelog is built."""
        pass
    
    def on_summary_generate(self, request: SummaryRequest) -> str:
        """Hook for custom AI summarization."""
        pass

Plugin Types

• Formatter plugins (custom output formats)
• AI provider plugins (bring your own LLM)
• Theme plugins (custom color schemes)
• Integration plugins (Slack, Discord, etc.)

---

Future Considerations (Post v2.0)

Potential Features

• Web UI companion application
• VS Code extension
• JetBrains IDE plugin
• GitHub App integration
• Self-hosted API server mode
• Team collaboration features
• Changelog analytics and insights

Community Features

• Plugin registry/marketplace
• Theme gallery
• Configuration sharing
• Best practices documentation

---

Contributing

We welcome contributions at any stage! See CONTRIBUTING.md for guidelines.

Priority Areas

1. Bug fixes and stability improvements
2. Documentation and examples
3. Test coverage expansion
4. Performance optimizations
5. New feature development

How to Get Involved

• Report bugs: Open an issue with reproduction steps
• Request features: Open a discussion for new ideas
• Submit PRs: Follow our coding guidelines
• Write docs: Help improve documentation
• Share: Spread the word about HelixCommit!

This roadmap is subject to change based on community feedback and priorities.