User Interface Guide

Main Interface Overview

Claudia features a comprehensive interface designed specifically for Claude Code development workflows. The application provides two main modes with distinct interfaces optimized for different tasks.

Welcome Screen

When you launch Claudia, you'll see the welcome screen with two primary options:

CC Projects Mode

Access comprehensive project and session management:

• Visual Project Browser: Grid view of all Claude Code projects
• Session Management: Browse and resume coding sessions
• Smart Search: Find projects and sessions quickly
• Session Insights: Analytics and development patterns

CC Agents Mode

Create and manage custom AI agents:

• Agent Library: Collection of specialized agents
• Agent Creation: Build custom agents with specific behaviors
• Execution Environment: Secure sandboxed agent execution
• Performance Monitoring: Track agent effectiveness and usage

CC Projects Interface

Project Browser

• Grid Layout: Visual cards showing project thumbnails and metadata
• Project Details: Name, last modified, session count, and file statistics
• Quick Actions: Start new session, view history, or open project directory
• Search Bar: Filter projects by name, content, or metadata

Session History View

• Session List: Chronological list of all sessions for a project
• Session Preview: First message and timestamp for each session
• Resume Options: Continue from any previous session
• Session Metadata: Duration, message count, and activity indicators

Session Interface

When working within a session:

• Timeline Navigation: Visual timeline with checkpoints and branches
• Message Area: Conversation history with Claude
• File Explorer: Project files with real-time change tracking
• Analytics Panel: Token usage, costs, and performance metrics

CC Agents Interface

Agent Library

• Agent Grid: Visual cards for each agent with custom icons
• Agent Categories: Organize agents by purpose (Web Dev, Data Analysis, etc.)
• Quick Actions: Execute, edit, or duplicate agents
• Performance Metrics: Success rates and efficiency statistics

Agent Creation Wizard

• Basic Configuration: Name, icon, and description
• System Prompt Editor: Rich text editor with syntax highlighting
• Model Selection: Choose appropriate Claude model
• Security Profile: Assign sandbox permissions and restrictions
• Testing Interface: Test agent behavior before deployment

Agent Execution Environment

• Real-time Monitoring: Watch agent execution progress
• Resource Usage: Monitor CPU, memory, and network usage
• Security Violations: Real-time alerts for permission violations
• Output Capture: Complete logs and results from agent execution

Navigation and Menu System

Top Menu Bar

• File Menu: Project operations, import/export, and preferences
• View Menu: Switch between CC Projects and CC Agents modes
• Tools Menu: Access MCP server management and analytics dashboard
• Help Menu: Documentation, support, and about information

Context Menus

Right-click on projects, sessions, or agents for quick actions:

• Projects: Open, rename, archive, or view analytics
• Sessions: Resume, fork, export, or delete
• Agents: Execute, edit, duplicate, or view performance history

Advanced Features Access

Usage Analytics Dashboard

Access via Menu → Usage Dashboard:

• Cost Overview: Real-time API usage and costs
• Token Analytics: Detailed consumption patterns
• Visual Charts: Interactive graphs and trend analysis
• Export Options: Generate reports for accounting

MCP Server Management

Access via Menu → MCP Manager:

• Server Registry: List of all configured MCP servers
• Connection Testing: Verify server connectivity
• Configuration Import: Import from Claude Desktop
• Server Monitoring: Health status and performance metrics

Timeline & Checkpoints

Available within active sessions:

• Visual Timeline: Branching timeline with checkpoint markers
• Checkpoint Creation: Manual and automatic save points
• Instant Restore: Jump to any previous state
• Session Forking: Create experimental branches

Advanced Sandboxing

Access via Settings → Security:

• Permission Profiles: Create and manage security configurations
• Violation Monitoring: Real-time security event tracking
• Profile Import/Export: Share configurations across teams
• Custom Rules: Define granular access controls

Customization and Settings

Interface Preferences

• Theme Selection: Choose from light, dark, or system themes
• Layout Options: Customize panel sizes and positions
• Font Settings: Adjust text size and font family
• Notification Preferences: Configure alerts and updates

Workflow Configuration

• Default Views: Set preferred starting interface (Projects or Agents)
• Auto-save Settings: Configure automatic checkpoint frequency
• Search Preferences: Customize search behavior and indexing
• Performance Settings: Optimize for your system resources

Keyboard Shortcuts

Global Shortcuts

• Cmd/Ctrl+N - New project or agent
• Cmd/Ctrl+O - Open project
• Cmd/Ctrl+S - Save/Create checkpoint
• Cmd/Ctrl+F - Search projects/sessions
• Cmd/Ctrl+, - Open preferences
• Cmd/Ctrl+Q - Quit application

Session Shortcuts

• Cmd/Ctrl+Enter - Send message
• Cmd/Ctrl+Z - Undo last action
• Cmd/Ctrl+Y - Redo action
• Cmd/Ctrl+B - Create checkpoint
• Cmd/Ctrl+R - Restore to checkpoint
• Escape - Cancel current operation

Navigation Shortcuts

• Cmd/Ctrl+1 - Switch to CC Projects
• Cmd/Ctrl+2 - Switch to CC Agents
• Cmd/Ctrl+3 - Open Analytics Dashboard
• Cmd/Ctrl+4 - Open MCP Manager
• Tab - Navigate between interface elements
• Shift+Tab - Navigate backwards

Tips for Efficient Use

Project Management Tips

1. Use descriptive project names for easy identification
2. Create regular checkpoints at logical stopping points
3. Leverage session search to find previous work quickly
4. Monitor usage analytics to optimize your workflow
5. Organize agents by purpose for quick access

Agent Development Tips

1. Start with templates for common agent types
2. Test agents in sandbox before production use
3. Monitor performance metrics to optimize agents
4. Use version control for agent configurations
5. Share successful agents with your team

Security Best Practices

1. Use appropriate permission profiles for different tasks
2. Monitor security violations regularly
3. Review agent permissions before execution
4. Keep security profiles updated with best practices
5. Test new configurations in safe environments

Performance Optimization

1. Close unused sessions to free resources
2. Use checkpoints strategically to balance safety and performance
3. Monitor system resources during agent execution
4. Optimize search indexes for better performance
5. Regular cleanup of old projects and sessions

Troubleshooting

Common Interface Issues

Projects Not Loading

• Verify Claude Code CLI installation
• Check ~/.claude directory permissions
• Refresh project browser
• Restart Claudia

Session Resume Problems

• Check session file integrity
• Verify Claude API connectivity
• Clear session cache
• Try creating new session

Agent Execution Failures

• Review sandbox permissions
• Check security violations log
• Verify agent configuration
• Test with minimal permissions

Performance Issues

• Close unused projects and sessions
• Clear analytics cache
• Monitor system resource usage
• Optimize checkpoint frequency

Search Not Working

• Rebuild search index
• Check file permissions
• Clear search cache
• Verify project file access

Need more help? Check the Installation Guide or explore our comprehensive Features Overview.