Lovelace Neovim Extension

Neovim extension for task submission and agent orchestration on the Lovelace platform

Overview

The Lovelace Neovim extension brings powerful AI agent orchestration directly into your editor. Submit tasks, monitor agent workers, and manage sessions without leaving your workflow.

Key Features:

✅ Submit tasks to AI agent workers
✅ Monitor agent worker status and task execution
✅ View results with syntax-highlighted diffs
✅ Apply code changes with a single keypress
✅ Authentication with device authorization flow
✅ Session persistence across Neovim sessions
✅ Local-first operation via Localhost daemon

Requirements

Neovim: 0.9.0 or later
Localhost Daemon: Running Lovelace Localhost daemon
Platform: Unix-like systems (Linux, macOS)

Default Keybindings

With default configuration (prefix = "<leader>l"):

Mode	Key	Command	Description
Visual	`<leader>lt`	`:LovelaceTask`	Submit selected code as task
Normal	`<leader>lT`	`:LovelaceTasks`	List all tasks
Normal	`<leader>la`	`:LovelaceAgents`	List agent workers
Normal	`<leader>lh`	`:LovelaceHealth`	Run health check

Available Commands

Command	Description
`:LovelaceHealth`	Check daemon connection and auth status
`:LovelaceAuth`	Show auth status or start device flow
`:LovelaceTask`	Submit task with description
`:LovelaceTasks`	List all tasks (queued, running, completed)
`:LovelaceAgents`	List agent workers and their status
`:LovelaceTaskStatus [task_id]`	Show detailed status of specific task
`:LovelaceCancel [task_id]`	Cancel running task
`:LovelaceSession`	Show current session/workspace info

For detailed command documentation, see the Command Reference.

Architecture

┌────────────────────────────────┐
│       Neovim Editor            │
│  ┌──────────────────────────┐  │
│  │  Lua Plugin              │  │
│  │  (lovelace.nvim)         │  │
│  └──────────┬───────────────┘  │
│             │ JSON-RPC         │
└─────────────┼──────────────────┘
              │
              ▼
   /tmp/lovelace-localhost.sock
              │
┌─────────────▼──────────────────┐
│   Localhost Daemon (Rust)      │
│   - Agent Pool Management      │
│   - Task Assignment            │
│   - Session Persistence        │
└────────────────────────────────┘

Key Concepts:

Task-Centric: Users submit tasks, not select agents
Agent Workers: Generic UUID-identified processes
Local-First: Communicates with local daemon via Unix sockets
Async Operations: Non-blocking design, never freezes editor

Quick Example

Submit your first task:

Open a file:
bash
```
nvim src/example.js
```
Select code (visual mode):
vim
```
V5j  # Select 5 lines
```
Submit task:
vim
```
:LovelaceTask
```
Enter description:
```
Refactor this function to use async/await
```
Wait for completion (notifications will appear)
Review results (opens automatically in split window)
Apply changes (in result buffer):
vim
```
a  # Press 'a' to apply
```

Next Steps

Installation - Install the Neovim extension
Quick Start - Submit your first task
Guides - Learn core workflows

Lovelace Developer Portal