Skip to content

OPIUM.md

Latest commit

 

History

History
756 lines (379 loc) · 11 KB

OPIUM.md

File metadata and controls

756 lines (379 loc) · 11 KB
Raw

OPIUS PROJECT OVERVIEW

Vision

Opius is an AI-native multi-agent development workspace inspired by BridgeMind, Cursor, tmux, and modern AI coding workflows.

The goal is to provide a single desktop environment where developers can:

  • Run multiple AI agents simultaneously

  • Organize agents in tiled terminal workspaces

  • Use voice commands

  • Load reusable skills

  • Maintain project memory

  • Manage files, git, browser, tasks, and history from one interface

Opius is built with:

  • Electron

  • React

  • TailwindCSS

  • TypeScript

  • xterm.js

  • node-pty

  • SQLite

CURRENT PRODUCT DIRECTION

For V1, focus only on:

Opius Workspace

Everything else is a future module.

Future modules:

  • Opius Memory

  • Opius Swarm

  • Opius Board

These should not distract from building the core workspace experience.

CORE WORKSPACE FLOW

When the application launches:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML Open Opius ↓ Workspace Setup Wizard ↓ Select Working Directory ↓ Choose Layout ↓ Select Preset ↓ Configure Agents ↓ Configure Skills ↓ Launch Workspace

STEP 1 — CREATE WORKSPACE

User enters:

  • Workspace Name

  • Working Directory

Methods:

  • Browse Folder

  • Direct path

  • cd command support

Example:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML cd C:\Projects\MyApp

STEP 2 — LAYOUT SELECTION

Supported layouts:

  • 1 Terminal

  • 2 Terminals

  • 4 Terminals

  • 6 Terminals

  • 8 Terminals

  • 10 Terminals

  • 12 Terminals

  • 16 Terminals

Requirements:

  • True tiling layout

  • No overlapping windows

  • No overflow

  • Responsive resizing

When more terminals are added:

  • Existing terminals shrink

  • Layout automatically rebalances

  • All terminals remain visible

Similar to:

  • tmux

  • tiling window managers

  • BridgeMind

TERMINAL BEHAVIOR

Each terminal is a real shell.

Supported:

  • Typing

  • Copy/Paste

  • Interactive CLI

  • AI agents

  • Keyboard shortcuts

Terminal states:

  1. Normal Tile

  2. Focus Mode

  3. Maximized

  4. Fullscreen

  5. Future Popout Window

Maximize:

  • Expand terminal into workspace

  • Preserve original layout

Restore:

  • Return to previous layout

No terminal state should be lost.

PRESETS

Users create presets.

Opius should not ship built-in presets.

Example:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML Frontend Team Backend Team Mobile Team Debug Team

Preset stores:

  • Layout

  • Agents

  • Skills

  • Working Directory

  • Custom Commands

Users can:

  • Save

  • Duplicate

  • Delete

  • Edit

AGENTS

Supported agent categories:

Premium

  • Claude Code

  • Codex CLI

  • Gemini CLI

  • Grok Build

Open Source

  • FreeBuff

  • Aider

  • OpenHands

  • Goose

  • Cline

  • Roo

  • OpenCode

Local

  • Ollama

  • DeepSeek

  • Qwen

  • Gemma

  • Llama

AGENT DETECTION

Opius automatically detects:

InstalledNot Installed

Examples:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML Claude Code ✓ Codex CLI ✓ Aider ✓ OpenHands Not Installed

Unavailable agents:

  • Disabled

  • Greyed out

  • Show install button

CUSTOM AGENTS

Users may launch unsupported agents.

Custom Agent:

Name:Launch Command:Install Command:

Example:

Name:My Agent

Launch Command:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML npx my-agent

Install Command:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML npm install -g my-agent

Opius launches the command directly.

SKILLS SYSTEM

Skills are reusable capability packs.

Inspired by:

https://www.skills.sh/

Examples:

  • Frontend Engineer

  • Backend Engineer

  • Flutter Expert

  • React Specialist

  • Security Auditor

  • Documentation Writer

Users can assign skills to specific agents.

Example:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML Claude → Frontend Engineer FreeBuff → Security Auditor Codex → Testing Expert

AUTOMATIC SKILL INSTALLATION

When user requests a skill:

Example:

"Launch 2 Claude terminals with a frontend skill."

Workflow:

  1. Check project skill directory

  2. If skill exists:Load skill

  3. If skill missing:Search skill registry

  4. Install skill automatically

  5. Attach skill to agent

No manual installation required.

OPIUS VOICE

Voice assistant name:

Opius

Users should be able to say:

"Opius"

to begin interaction.

VOICE MODES

Assistant Mode

Conversation with Opius.

Examples:

"Create 4 terminals"

"Open the browser"

"Launch Claude"

Prompt Mode

User selects terminal.

User speaks.

Speech is transcribed.

Transcript is inserted into selected terminal input box.

User reviews text.

User edits text.

User manually presses Enter.

Opius should NEVER auto-send prompts.

User always retains control.

VOICE STACK

Speech To Text:

  • Whisper.cpp

Text To Speech:

Preferred:

  • ElevenLabs

Fallback:

  • Kokoro

Last Resort:

  • Web Speech

Users can choose provider.

WORKSPACE SIDEBAR

Collapsible right sidebar.

Modes:

Browser

Embedded browser.

Used for:

  • Documentation

  • Research

  • AI dashboards

Files

Project file explorer.

Git

Repository status.

Future:

  • Commit

  • Branches

  • Diff Viewer

Memory

Project memory.

Stores:

  • Architecture

  • Decisions

  • Notes

  • Agent context

Tasks

Task management.

Future integration with agents.

History

Workspace snapshots.

Used for:

  • Undo

  • Recovery

  • Time machine

MEMORY SYSTEM

Workspace memory should remember:

  • Project summary

  • Decisions

  • Agent preferences

  • Architecture notes

  • User notes

When project reopens:

Memory reloads automatically.

Users do not need to explain the project repeatedly.

SNAPSHOT SYSTEM

Before agents execute work:

Create snapshot.

Snapshot stores:

  • Files

  • State

  • Workspace metadata

Users can:

Restore Snapshot

if:

  • AI produces bad code

  • Agent stops midway

  • Subscription limits interrupt work

HISTORY PANEL

Example:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML 2:00 PM Workspace Created 2:15 PM Claude Login System 2:40 PM Codex API Refactor 3:05 PM FreeBuff UI Cleanup

User can restore any point.

DESIGN LANGUAGE

Inspired by:

  • BridgeMind

  • Cursor

  • Linear

  • Raycast

Not inspired by:

  • Traditional IDEs

  • Visual Studio

  • Eclipse

Goals:

  • Modern

  • Premium

  • Minimal

  • Fast

COLOR PALETTE

Primary:

Opius Blue

Accent:

Electric Blue

Surface:

Dark Slate

Avoid:

Pure black backgrounds.

Use dark charcoal instead.

Examples:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML Background: #111827 Panels: #1F2937 Borders: #374151 Primary: #3B82F6 Accent: #60A5FA

TERMINAL DESIGN

Terminals should match Opius branding.

Requirements:

  • Rounded corners

  • Premium cards

  • Subtle borders

  • Blue accents

  • Consistent spacing

Not:

  • Raw black terminal windows

Goal:

Terminals should feel like part of the application.

LOGO

Asset:

opius.png

Dimensions:

500x500

Use in:

  • Landing Page

  • Sidebar

  • Header

  • Splash Screen

  • Installer

Maintain aspect ratio.

Do not resize disproportionately.

FUTURE MODULES

Opius Memory

Shared project memory.

Opius Swarm

Multi-agent collaboration.

Agents communicate and coordinate.

Opius Board

Kanban workflow.

Columns:

  • Todo

  • Doing

  • Review

  • Done

Tasks can be assigned to agents.

DEVELOPMENT PRIORITY

  1. Workspace UI

  2. Real terminals

  3. Agent launcher

  4. Presets

  5. Skills

  6. Voice

  7. Browser/File/Git sidebar

  8. Memory

  9. Snapshots

  10. Swarm

  11. Board

Focus on making Workspace exceptional before building future modules.