# ollie-kde

KDE-native integration for [ollie](../README.md) — thin KDE clients (GUI application, KRunner plugin, Kate plugin, Dolphin menus) that connect to the Ollie 9P filesystem via `olliesrv`.

## Architecture

```
┌─────────────────────────────────────────────────────────┐
│                     Plasma Desktop                       │
│  GUI App │ KRunner │ Kate Plugin │ Dolphin               │
└──────────┬──────────────┬──────────────────┬─────────────┘
           │              │                  │
           │  ┌───────────┴──────────────┐  │
           │  │  9P client tools         │  │
           │  │  libollie9p  │  ollie-9p │  │
           │  │  plan9port's 9p          │  │
           │  └───────────┬──────────────┘  │
           │              │                  │
           └──────────────┼──────────────────┘
                          │ 9P protocol (Unix socket)
                          │
               ┌──────────┴──────────┐
               │   olliesrv (../9p)   │
               │   9P server          │
               │   Go │ lib9p         │
               └─────────────────────┘
```

Every KDE component talks to `olliesrv` via 9P protocol using one of the available 9P clients (`libollie9p.so` directly, `ollie-9p` subprocess, or plan9port's `9p`).

## Components

- **ollie-gui** — Main Qt/QML GUI application with session management and chat interface
- **krunner_ollie.so** — KRunner plugin for quick prompts and session management
- **ollie_kate.so** — Kate plugin with integrated chat panel and editor integration
- **Dolphin service menus** — Right-click actions for files and directories

**Note**: No system tray component exists.

## Dependencies

- Qt 6 (Core, Widgets, Quick, QuickControls2) or Qt 5 (Core, Widgets, Quick, Qml, QuickControls2)
- KDE Frameworks 6 (Runner, CoreAddons, Config, TextEditor, SyntaxHighlighting) or KF5 equivalents
- ECM (Extra CMake Modules)
- libollie9p.so (from `../lib9p/`)

KF6/Qt6 is the default. To build against KF5/Qt5:
```sh
just kde-kf5
```

## Build

```sh
just kde          # builds all components (KF6)
just kde-kf5      # builds all components (KF5)
```

Outputs:
- `build-cmake/ollie-gui` — main GUI application
- `build-cmake/lib/kf6/krunner/krunner_ollie.so` — KRunner plugin
- `build-cmake/lib/kf6/ktexteditor/ollie_kate.so` — Kate plugin

## Install

```sh
just install-kde      # installs all KDE components (KF6)
just install-kde-kf5  # installs all KDE components (KF5)
```

The installation:
- Installs binaries to `~/.local/bin/`
- Installs plugins to `~/.local/lib64/qt6/plugins/` (KF6) or `~/.local/lib/qt5/plugins/` (KF5)
- Installs Dolphin service menus to `~/.local/share/kio/servicemenus/`
- Installs desktop entry to `~/.local/share/applications/`
- Installs icon to `~/.local/share/icons/hicolor/scalable/apps/`
- Sets up environment script in `~/.config/plasma-workspace/env/`

**Note**: Restart Plasma (`plasmashell --replace` or log out/in) to pick up new plugins.

## Usage

### GUI Application (`ollie-gui`)

Launch from application menu or terminal:
```sh
ollie-gui
```

Features:
- Session list with state indicators (idle, thinking, tool call)
- Live chat view with auto-scroll
- Inline prompt input
- Real-time updates via 9P polling
- Theme support (light/dark/system)

### KRunner

- `ollie <prompt>` — one-shot generation via `Generate` (no session created); shows result in a popup
- `ollie list` — show active sessions
- `ollie kill <id>` — terminate a session

### Dolphin

Right-click any file or directory:
- **Ask Ollie about this** — one-shot prompt with file context, shows result in kdialog
- **Start Ollie session here** — creates a persistent session in that directory

### Kate

Enable the "Ollie" plugin in Settings → Configure Kate → Plugins. Panel appears on the right with:

- Session indicator + CWD label
- **New** — create session in project/file directory
- **Ask File** — send current file path for description
- **Explain** — send selected text for explanation
- Prompt input for free-form messages
- Live-streaming chat view
- Editor integration (inline annotations, code block application, ghost text completion)

## File Layout

```
ollie-kde/
├── justfile                        # Build orchestration
├── CMakeLists.txt                  # Main CMake configuration
├── gui/
│   ├── main.cpp                    # GUI application entry
│   ├── main.qml                    # QML interface
│   ├── ollie9pclient.h/cpp         # 9P client for GUI
│   ├── lib9pclient.h/cpp           # Shared 9P client library
│   ├── chatblockmodel.h/cpp        # Chat data model
│   ├── thememanager.h/cpp          # Theme management
│   ├── streamfsm.h/cpp             # Streaming state machine
│   ├── ninepconnection.h/cpp       # 9P connection management
│   └── org.ollie.gui.desktop       # Desktop entry
├── krunner/
│   ├── metadata.json               # Plugin metadata
│   └── ollie_runner.h/cpp          # KRunner plugin (9P-based)
├── kate/
│   ├── metadata.json               # Plugin metadata
│   ├── ollie_kate.h/cpp            # Kate plugin (9P-based)
│   ├── ollie_ghost.h/cpp           # Ghost text provider (9P-based)
│   ├── chat_renderer.h/cpp         # Chat rendering engine
│   ├── ktexteditor_utils.h         # Editor utilities
│   └── diffparams.h                # Diff viewer parameters
├── dolphin/
│   ├── ollie-actions.desktop       # Service menu entries (KF6)
│   ├── ollie-actions-kf5.desktop   # Service menu entries (KF5)
│   ├── ollie-ask                   # One-shot helper script (9P-based)
│   └── ollie-session-here          # Session creation helper (9P-based)
├── 99-ollie.sh                     # Environment script (KF6)
├── 99-ollie-kf5.sh                 # Environment script (KF5)
```

## Development Notes

- **All components use `ollie-9p` for 9P transport**
- The Kate plugin includes sophisticated editor integration with ghost text, inline annotations, and diff viewing
- The GUI application uses Qt Quick for a modern, responsive interface
- Build system supports both KF6/Qt6 and KF5/Qt5 via CMake option `OLLIE_KF5`
- Installation is user-local (`~/.local/`) by default, no system-wide installation needed

## Troubleshooting

**Plugins not appearing after installation:**
- Run `kbuildsycoca6` (KF6) or `kbuildsycoca5` (KF5) to rebuild system cache
- Restart Plasma: `plasmashell --replace` or log out/in

**"ollie-9p not found" errors:**
- Ensure `ollie-9p` is in your PATH or build/install the main Ollie project first

**Kate plugin crashes:**
- Check that `libollie9p.so` is installed in `~/.local/lib/`
- Verify Kate is using the same Qt version as the plugin (Qt5 vs Qt6)

**Dolphin actions not working:**
- Ensure `ollie-ask` and `ollie-session-here` are installed in `~/.local/bin/`
- Check that the service menu desktop files are in `~/.local/share/kio/servicemenus/`