Wanderland Clients

Registry of all clients that interface with the Wanderland/Oculus API. Keep in sync when adding new features.

Client Inventory

MCP Proxy

Location: /Users/graemefawcett/org/mcp-proxy/tools/oculus-tools.js Key Field: fence_path (API param name)

Status: ✅ Updated - sends fence_path: args.path

---

Oculus CLI

Location: /Users/graemefawcett/working/wanderland/oculus-api/oculus/cli.py Commands: oculus fence execute, oculus exec Key Field: fence_path (body param)

Status: ✅ Updated - sends body['fence_path'] = path

---

Neovim Plugin

Location: ~/.config/nvim/lua/wanderland.lua Function: oculus_execute_virtual_fence() Key Field: fence_path (body param)

Status: ✅ Updated - sends body.fence_path = opts.path

---

Toodles

Location: /Users/graemefawcett/working/toodles/src/toodles/cli.py Function: execute_action() Key Field: fence_path (body param)

Status: ✅ Updated - sends body['fence_path'] = index_or_path

---

Stuffy CLI

Location: /Users/graemefawcett/working/wanderland/stuffy-cli/ Status: ✅ N/A - streaming only, no fence operations

API Endpoints Reference

Virtual Fence Execution

Index-based (legacy):

POST /api/oculus/virtual-fences/{slug}/{index}/execute
Body: { action, params, context }

Path-based (preferred):

POST /api/oculus/virtual-fences/{slug}/execute
Body: { action, params, context, path }

Path formats:

• Pre-Flight Checklist - section name (auto-detect fence type)
• Pre-Flight Checklist.todo - explicit todo list
• Scores.table - explicit table
• my-section.badge - explicit badge

Regular Fence Execution

POST /api/oculus/fences/{fence_id}/execute
Body: { params, force, format, action, context }

Sync Checklist

When adding new features:

• MCP Proxy - tool schema in mcp-proxy-server.js
• MCP Proxy - endpoint mapping in tools/oculus-tools.js
• Oculus CLI - command in cli.py
• Neovim Plugin - function in wanderland.lua
• Toodles - if relevant
• This doc - update status

Activity Log

Date	Change	Clients Updated
2026-01-03	fence_path param sync	MCP, CLI, Neovim, Toodles
2025-12-22	Path-based virtual fence addressing	MCP Proxy

East

slots:
- slug: wanderland-client-sync-howto
  context:
  - Linking client registry to sync how-to guide

South

slots:
- slug: neovim-wanderland
  context:
  - Linking client registry to neovim implementation docs
- slug: oculus-cli
  context:
  - Linking client registry to CLI implementation docs
- slug: toodles-manual
  context:
  - Linking client registry to toodles implementation docs
- slug: pippi-manual
  context:
  - Linking PIPPI to client registry
- slug: wanderland-databases
  context:
  - Database reference under client infrastructure

Provenance

Document

• Status: 🔴 Unverified

Fences

wanderland-clients-virtual-fence-execution-fence-0

• Status: 🔴 Unverified

wanderland-clients-virtual-fence-execution-fence-1

• Status: 🔴 Unverified

wanderland-clients-regular-fence-execution-fence-0

• Status: 🔴 Unverified

wanderland-clients-east-fence-0

• Status: 🔴 Unverified

wanderland-clients-south-fence-0

• Status: 🔴 Unverified