Omnara Agent Dashboard

Omnara acts as a synchronization layer between AI Agents and Client Applications (Web/Mobile). The architecture is divided into several layers:

• Integration Layer: Provides multiple ways to interact with the platform, including a Python SDK, Node.js CLI, MCP (Model Context Protocol), and a REST API.
• API Layer:
  • Backend API (FastAPI): Handles read operations and serves Web/Mobile clients via WebSocket/REST.
  • Servers API (FastAPI + MCP): Handles write operations (e.g., from agents) via port :8080.
• Authentication: Uses Supabase Auth for web users and Custom JWT for agent authentication.
• Data Layer: Uses PostgreSQL for primary storage and an optional Redis Cache.

Integration Methods by Agent Type

• Claude Code / Cursor: Connect via MCP.
• GitHub Copilot: Connect via REST API.
• Custom Agents: Connect via the Python SDK.

The @anthropic-ai/claude-code-action GitHub integration provides an automated agent that interacts with your repository via comments.

Key Capabilities:

• Single-Comment Communication: Claude operates by updating a single initial comment with progress and results rather than posting multiple new comments.
• Code Implementation & Review: It can implement simple to moderate code changes, answer questions about the codebase, and perform code reviews by analyzing PR changes.
• Pull Request Preparation: It creates commits on a branch and provides a link to a prefilled PR creation page.
• Smart Branching Logic:
  • On an Issue: Always creates a new branch for the work.
  • On an Open PR: Pushes directly to the existing PR branch.
  • On a Closed PR: Creates a new branch (as the original is inactive).
• CI/CD Visibility: If configured with actions: read permissions, Claude can view workflow runs, job logs, and test results on the tagged PR.

To enable runtime theme management, wrap your application in the ThemeProvider and use the useTheme hook to control or access the current theme state.

Setup Theme Provider

Wrap your main App component with ThemeProvider from @/lib/theme/ThemeProvider:

import { ThemeProvider } from '@/lib/theme/ThemeProvider';

function App() {
  return (
    <ThemeProvider defaultTheme="dark">
      <YourAppContent />
    </ThemeProvider>
  );
}

Using Theme Context

Access theme, setTheme, and toggleTheme via the useTheme hook:

import { useTheme } from '@/lib/theme/ThemeProvider';

function MyComponent() {
  const { theme, setTheme, toggleTheme } = useTheme();
  
  return (
    <button onClick={toggleTheme}>
      Current theme: {theme}
    </button>
  );
}

import { ThemeProvider } from '@/lib/theme/ThemeProvider';

function App() {
  return (
    <ThemeProvider defaultTheme="dark">
      <YourAppContent />
    </ThemeProvider>
  );
}

// In a component
import { useTheme } from '@/lib/theme/ThemeProvider';

function MyComponent() {
  const { theme, setTheme, toggleTheme } = useTheme();
  return <button onClick={toggleTheme}>{theme}</button>;

The anthropics/claude-code-action@v1 action automatically detects the execution mode based on your workflow configuration:

1. Automation Mode (Agent Mode): Triggered when a prompt input is provided. This is used for direct execution without requiring mentions, ideal for automated PR reviews or scheduled tasks.
2. Interactive Mode (Tag Mode): Triggered when no prompt is provided but @claude is mentioned in comments, an issue is assigned to the claude user, or a label is applied. This mode creates tracking comments with progress checkboxes.
3. No Action: If neither a prompt is provided nor @claude is mentioned, the action does nothing.

### Automation Mode (Agent Mode)
```yaml
- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: |
      Check for outdated dependencies and create an issue if any are found.
    # Automatically runs in agent mode when prompt is provided

Interactive Mode (Tag Mode)

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    # No prompt needed - responds to @claude mentions