Skip to content

Feature/chat history browsing #2505

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: main
Choose a base branch
from

Conversation

mibeco
Copy link
Contributor

@mibeco mibeco commented Aug 6, 2025

Q History: Enhanced Conversation Management

With q history , customers can search, review, save, and share conversations that might otherwise get forgotten or overwritten.

  • Browse your conversation history with filtering
  • Search through conversation content
  • Export conversations in multiple formats (JSON, Markdown, Text)
  • Restore conversations to continue them later
  • Seamlessly integrate with existing /save and /load commands

See the README for more details, including testing instructions.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

mibeco and others added 9 commits August 3, 2025 16:35
🎯 New Features:
- Browse conversation history with filtering (list, search)
- Export conversations in multiple formats (JSON, Markdown, Text)
- Restore conversations to continue them later
- Seamless integration with existing /save and /load commands

📋 Commands Added:
- q history list [--limit N] [--path PATH] [--contains TEXT]
- q history search <query> [--limit N]
- q history show <id>
- q history export <id> --output <file> [--format FORMAT] [--force]
- q history restore <id>

🔧 Technical Implementation:
- Full SQLite database integration for conversation storage
- Multi-format export with identical JSON serialization as /save
- Robust error handling and user-friendly feedback
- Comprehensive test coverage (23 tests passing)
- Smart path truncation and table formatting

💡 Key Benefits:
- Perfect compatibility with existing /load command
- Automatic conversation backup and restoration
- Powerful search with contextual previews
- Developer-friendly workflow for documentation and sharing

📚 Documentation:
- Complete README with usage examples
- Step-by-step setup instructions
- Troubleshooting guide and workflow examples

This feature transforms Q CLI into a comprehensive conversation management system,
bridging automatic database storage with manual file-based sharing and backup.
added troubleshooting
- Add missing triple backticks to all code blocks
- Fix formatting for troubleshooting section
- Ensure proper rendering of bash code examples
- Prioritize symlink approach (Option A) as it was actually tested and works reliably
- Use 'qdev' consistently throughout examples for realistic user experience
- Reorder options based on reliability and ease of use
- Ensure all commands match what was actually tested and verified
- Remove redundant basic usage examples (now in README)
- Focus on comprehensive testing, edge cases, and QA scenarios
- Add performance benchmarks and stress testing
- Include security and privacy testing considerations
- Update commands to use 'qdev' consistently
- Add cross-reference to README for basic usage
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant