Skip to content

CBOS Next Steps

Session setup guide for continuing development.

Open GitHub Issues

TUI Enhancements

#1 - TUI: Add task routing keybinding (n) - Add n keybinding for new task routing flow - Prompt user for task description - Call POST /sessions/route with description - Display recommended session with reasoning - Quick action to send task or create new session - Reference: Feature 5 in THE-PLAN.md - Status: API endpoint /sessions/route already implemented

#2 - TUI: Show session summaries in list view - Display 1-line AI-generated summary next to each session name - Call /sessions/{slug}/summary for each session - Cache summaries to avoid excessive API calls - Full summary visible when session selected - Reference: Feature 2 in THE-PLAN.md - Status: SessionSummarizer already implemented with caching

#3 - TUI: Accept/edit/reject flow for suggestions - Complete the suggestion interaction flow - Keybindings when suggestion panel visible: - Enter - Accept suggestion, send to session - e - Edit suggestion before sending - Esc - Dismiss suggestion - Current state: s keybinding shows panel, displays suggested response - Missing: interaction to accept/edit/reject

Background Processing

#4 - Background embedding updates - Periodically update session embeddings without user action - Add background task to refresh loop (or separate interval) - Update embeddings every N seconds (configurable, default 60s) - Only update if buffer has changed significantly (use buffer hash) - Benefits: Related sessions detection, task routing, cross-session awareness - Status: SessionEmbeddingStore.update() already implemented

Architecture Reference

TUI (Textual) → FastAPI (port 32205) → SessionStore → ScreenManager → GNU Screen
                      ↓
              Intelligence Service
              (suggestions, summaries, embeddings, routing)

Quick Start

# Activate environment
source ~/.pyenv/versions/nominates/bin/activate

# Run the TUI
cbos

# Start the API server (if not running)
cbos-api

# Run tests
pytest tests/ -v

Key Files for Current Work

Feature Key Files
Task routing (#1) cbos/tui/app.py, cbos/api/main.py
Session summaries (#2) cbos/tui/app.py, cbos/intelligence/summarizer.py
Suggestion flow (#3) cbos/tui/app.py, cbos/intelligence/suggestions.py
Background embeddings (#4) cbos/api/main.py, cbos/intelligence/embeddings.py

Implementation Priority

Recommended order based on dependencies:

  1. #4 Background embedding updates - Foundation for routing and related sessions
  2. #3 Accept/edit/reject flow - Complete existing suggestion feature
  3. #2 Session summaries in list - Improves TUI usability
  4. #1 Task routing keybinding - Depends on embeddings being up-to-date

Recent Changes

  • v0.3.0: Added skills architecture for reusable workflows
  • v0.2.0: Maintenance cycle - code quality and documentation cleanup
  • v0.4.0: Added orchestrator with pattern matching and WebSocket listener