> ## Documentation Index
> Fetch the complete documentation index at: https://docs.charle.agency/llms.txt
> Use this file to discover all available pages before exploring further.

# Navigation

> Learn how to navigate CharleOS and find features quickly

CharleOS is designed for efficient navigation with multiple ways to access features. This guide covers the main navigation patterns and keyboard shortcuts to help you work faster.

## Main interface layout

The CharleOS interface has three main components that work together:

<CardGroup cols={3}>
  <Card title="Sidebar" icon="bars">
    Your main navigation menu with all features organized by section
  </Card>

  <Card title="Header" icon="window-maximize">
    Quick access to search, Alan AI, notifications, and your profile
  </Card>

  <Card title="Main Content" icon="browser">
    The primary workspace showing dashboards, tables, forms, and data
  </Card>
</CardGroup>

## Sidebar navigation

The collapsible sidebar on the left is your main navigation hub. It's organized into permission-based sections:

#### Personal (All users)

* **Dashboard** - Your personalized dashboard
* **My Schedule** - Your personal schedule view
* **My Time Tracking** - Log and view your time entries

#### Work (Permission-based)

* **Clients** - Client profiles and retainers
* **Quotes** - Quote creation and approval
* **Tasks** - Task management and delivery
* **Blocks** - Recurring work blocks
* **Help Desk** - Support tickets
* **Schedule** - Team scheduling
* **Projects** - Fixed-scope project management
* **RAG** - Reporting and analytics

#### Management (Managers)

* **Time Tracking** - Team time entry oversight
* **Annual Leave** - Leave request management

#### Reports (Managers)

* **Executive** - High-level metrics
* **Financial** - Revenue and profitability
* **Operations** - Delivery and efficiency
* **Capacity Planning** - Resource forecasting
* And more specialized reports...

<Tip>
  The sidebar can be collapsed to icon-only mode by clicking the collapse button at the bottom. This gives you more screen space while keeping navigation accessible.
</Tip>

## Header bar

The header at the top provides quick access to global features:

### Command Menu (⌘K)

Click the search button or press `⌘K` (Mac) / `Ctrl+K` (Windows) to open the command menu - your fastest way to find anything.

### Alan AI Assistant

Click the sparkles icon to open Alan, your AI assistant for:

* Scheduling help and recommendations
* Data queries in natural language
* Documentation questions

### Active Tasks (Delivery Team)

Quick access button to view and start/stop time tracking on your active tasks.

### Notifications

Bell icon shows unread notifications. Click to view:

* Task assignments
* Quote requests
* Schedule changes
* System updates

### Theme Toggle

Switch between light, dark, and system theme preferences.

### User Menu

Click your avatar to access:

* **Settings** - Profile and notification preferences
* **Notifications** - Full notification history
* **Annual Leave** - Request and view leave
* **Log out** - Sign out of CharleOS

## Command menu (⌘K)

The command menu is the fastest way to navigate and search CharleOS.

### How to use it

1. **Open**: Press `⌘K` (Mac) or `Ctrl+K` (Windows), or click the search button
2. **Type**: Start typing to search across all entities
3. **Select**: Use arrow keys or mouse to select a result
4. **Go**: Press Enter to navigate to that item

### What you can search

The command menu searches across:

* **Clients** - Find any client by name
* **Tasks** - Search tasks by title or ID
* **Quotes** - Find quotes by title or client
* **Projects** - Locate projects
* **Users** - Find team members
* **Help Desk Tickets** - Search support tickets
* And more...

### Ask Alan from command menu

Can't find what you're looking for? Type your question in the command menu and select **"Ask Alan"** to get AI-powered help.

<Tip>
  The command menu remembers your recent searches for quick access to frequently viewed items.
</Tip>

## Keyboard shortcuts

Master these shortcuts to navigate CharleOS like a pro:

| Shortcut        | Action                                      |
| --------------- | ------------------------------------------- |
| `⌘K` / `Ctrl+K` | Open command menu                           |
| `⌘/` / `Ctrl/`  | Focus search                                |
| `Esc`           | Close dialogs/modals                        |
| `?`             | Show keyboard shortcuts help (if available) |

<Note>
  More keyboard shortcuts are being added. Press `?` in the future to see a full list.
</Note>

## Dashboard navigation (Managers)

If you're a manager, your dashboard includes a tabbed interface to switch between different views:

### Dashboard tabs

* **Agency Dashboard** - Agency-wide metrics and team scheduling
* **Department Dashboards** - Separate tabs for Design, Development, New Business, Operations
* **Individual Dashboard** - Your personal dashboard (if you have a work type)

Click between tabs to switch contexts without leaving the dashboard page.

## Role-based navigation

Your navigation is customized based on your role and work type:

### Delivery Team

See: Personal navigation and Work features

### Project Managers

See: Personal + Work + some Management features

### Customer Success Managers

See: Personal + Work features, client-focused views

### Managers

See: Personal + Work + Management + Reports

<Info>
  If you can't see a feature mentioned in the documentation, you may not have the required permissions. Contact your manager if you need access.
</Info>

## Tips for efficient navigation

<CardGroup cols={2}>
  <Card title="Use Command Menu First" icon="keyboard">
    Before clicking through menus, try ⌘K to search - it's almost always faster
  </Card>

  <Card title="Bookmark Common Pages" icon="bookmark">
    Use browser bookmarks for pages you visit daily (your dashboard, time tracking, etc.)
  </Card>

  <Card title="Collapse the Sidebar" icon="sidebar">
    Collapse the sidebar when viewing tables or forms to maximize screen space
  </Card>

  <Card title="Ask Alan for Help" icon="sparkles">
    If you can't find something, ask Alan "Where do I find X?" and he'll guide you
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Meet Alan" icon="sparkles" href="/user-guide/alan">
    Learn what you can ask your AI assistant
  </Card>

  <Card title="Time Tracking" icon="clock" href="/user-guide/time-tracking">
    Start logging time against your tasks
  </Card>

  <Card title="Schedule" icon="calendar" href="/user-guide/schedule">
    Explore the scheduling system
  </Card>

  <Card title="Tasks" icon="check-square" href="/user-guide/tasks">
    Learn how to manage and deliver tasks
  </Card>
</CardGroup>