v1.6.0 - Stable Release
🎉 Basic Agent Chat Loop v1.6.0 - Stable Release
This is a stable production release bringing project-local session management and improved UX.
🎯 Breaking Changes
Session Storage Now Project-Local
- Sessions now save to
./.chat-sessions/in current directory instead of global~/agent-conversations/ - Provides better context separation between different projects
- Old sessions remain accessible in
~/agent-conversations/but new sessions use project-local storage - Configuration option
paths.save_locationhas been removed
Migration Notes: If you have existing sessions in ~/agent-conversations/, they remain accessible but new sessions will be saved to ./.chat-sessions/ in your project directory. To access old sessions, you can either:
- Manually move them to
./.chat-sessions/in relevant projects - Keep them in the old location for reference (they won't be deleted)
✨ New Features
Improved #resume Command UX
#resumewithout arguments now displays available sessions instead of showing an error- Reduces friction - no need to run
#sessionsseparately first - Shows helpful usage message after session list
Context Monitoring (from beta.7)
- New
#contextcommand shows token usage and session statistics - Status bar shows context usage percentage
- Configurable warning thresholds via
context.warning_thresholdsin config - Auto-suggest
#compactcommand when approaching context limits
🛠️ Improvements
Config Wizard Updates
- Updated help text to reference new
./.chat-sessionslocation - Removed
save_locationprompts from wizard flow - All documentation updated to reflect project-local session storage
Token Tracking (from beta.7)
- Fixed AWS Strands token counting accuracy
- Proper handling of streaming response token counts
- Better aggregate token statistics
📝 What's Changed Since v1.5.1
v1.6.0-beta.8 (2025-12-30)
- fix: update config wizard help text to reference ./.chat-sessions
- feat: change session storage to project-local ./.chat-sessions
- feat: improve #resume command UX to show sessions when no arg provided
v1.6.0-beta.7 (2025-12-30)
- feat: add context usage monitoring with #context command
- feat: add configurable context warning thresholds
- feat: display context % in status bar
- fix: accurate token counting for AWS Strands agents
📦 Installation
pip install basic-agent-chat-loop==1.6.0Or upgrade from previous version:
pip install --upgrade basic-agent-chat-loop📚 Documentation
- README: View on GitHub
- Configuration Guide: docs/CONFIG.md
- Changelog: CHANGELOG.md
🙏 Thank You
Thank you to all users who tested the beta releases and provided feedback!
Full Changelog: v1.5.1...v1.6.0