Project & Session Management

Overview

Claudia provides comprehensive project and session management capabilities, making it easy to organize, navigate, and resume your Claude Code development work.

Visual Project Browser

Navigate through all your Claude Code projects stored in ~/.claude/projects/ with an intuitive visual interface:

• Project Grid View: See all your projects at a glance with project thumbnails and metadata
• Folder Structure: Browse projects organized by their directory structure
• Quick Access: Jump directly to any project with a single click
• Project Details: View project information including creation date, last modified, and file count

Session History

Keep track of all your coding sessions with comprehensive history management:

• Session Timeline: View chronological list of all past sessions
• Full Context Preservation: Each session maintains complete conversation history
• Resume Capability: Pick up exactly where you left off in any previous session
• Session Metadata: Access detailed information about each session

Session Information

Each session displays:

• First Message: Preview of how the session started
• Timestamps: Creation time and last activity
• Duration: Total time spent in the session
• Message Count: Number of exchanges in the conversation
• Project Association: Which project the session belongs to

Smart Search

Find projects and sessions quickly with powerful search capabilities:

• Global Search: Search across all projects and sessions simultaneously
• Keyword Matching: Find content by keywords in project names, session messages, or file contents
• Filter Options: Narrow results by date, project type, or session duration
• Recent Items: Quick access to recently accessed projects and sessions

Search Features

• Instant Results: Real-time search as you type
• Context Highlighting: See where your search terms appear
• Advanced Filters: Filter by date range, project size, or activity level
• Saved Searches: Save frequently used search queries for quick access

Session Insights

Get valuable insights into your development patterns and productivity:

• Activity Overview: See your coding activity patterns over time
• Project Statistics: Understand which projects you work on most
• Session Analytics: Track session length, frequency, and productivity metrics
• Progress Tracking: Monitor your development progress across projects

Insight Metrics

• Daily/Weekly Activity: Visualize your coding schedule
• Project Time Distribution: See how you allocate time across different projects
• Session Effectiveness: Metrics on session outcomes and achievements
• Collaboration Patterns: Track when you work solo vs. with AI assistance

Getting Started

Initial Setup

1. Launch Claudia: Open the application after installation
2. Welcome Screen: Choose "CC Projects" from the main menu
3. Auto-Detection: Claudia automatically scans your ~/.claude directory
4. Project Import: All existing Claude Code projects are immediately available

Managing Projects

1. Browse Projects: Navigate to CC Projects → Select Project
2. View Sessions: See all sessions associated with the selected project
3. Resume Work: Click on any session to resume from where you left off
4. Start New: Begin a new session within any project

Workflow Example

CC Projects → Select "My Web App" → View Sessions → 
See "Frontend Refactoring" session from yesterday → 
Resume to continue the conversation

Best Practices

Organization Tips

• Descriptive Names: Use clear, descriptive names for your projects
• Regular Sessions: Break work into focused sessions rather than marathon coding
• Session Notes: Start sessions with clear objectives in the first message
• Clean Workspace: Regularly archive completed projects to keep the browser organized

Productivity Guidelines

• Session Planning: Begin each session with a clear goal
• Context Setting: Provide relevant context in your opening messages
• Regular Checkpoints: Create natural stopping points in long sessions
• Review History: Use session insights to improve your development patterns

Troubleshooting

Common Issues

Projects Not Appearing

• Verify Claude Code CLI is properly installed
• Check that projects exist in ~/.claude/projects/
• Refresh the project browser

Session History Missing

• Ensure proper permissions for the ~/.claude directory
• Check for corrupted session files
• Restart Claudia to refresh the session cache

Search Not Working

• Clear search cache in settings
• Rebuild search index
• Check for special characters in search terms

Ready to explore more features? Check out our CC Agents documentation to learn about custom AI agents.