> ## Documentation Index
> Fetch the complete documentation index at: https://lunr-f6858e75.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

* [x] 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

<Accordion title="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/
  ```
</Accordion>

***

## 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

<Accordion title="Plugin System Example">
  ```python theme={}
  # 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
  ```
</Accordion>

### 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](https://github.com/bjornefisk/HelixCommit/blob/main/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!

<Info>
  This roadmap is subject to change based on community feedback and priorities.
</Info>