Olympus Lens (VS Code Extension)

Olympus Lens is the official Visual Studio Code extension for developing on the Olympus Cloud platform. It connects your local editor to the ACP (Advanced Coding Platform) brain.

---

Installation

1. Open the Extensions view in VS Code (Ctrl+Shift+X).
2. Search for "Olympus Lens".
3. Click Install.
4. Run the command Olympus: Connect to authenticate with your dev environment.

---

Key Features

1. AI Collaboration with Context

Interact with Olympus AI agents (Claude, Gemini) directly from your editor. unlike generic assistants, Olympus Lens has deep context:

• Project Structure Awareness: Knows the difference between backend/rust and frontend/lib.
• Architecture Validation: Warns you if your code violates Olympus architectural rules.
• Documentation Access: Can pull up relevant internal docs instantly.

2. Code Navigation & Search

• Semantic Search: Press Cmd+P and type ? to ask semantic questions about the codebase (e.g., "Where is the auth logic?").
• Dependency Graph: Right-click a file > Show Dependencies to see what uses it.

3. Integrated Tools

note

Database queries from the extension are read-only and restricted to the dev environment. You cannot modify data or query staging/production from within VS Code.

Run cloud operations without leaving the editor:

• Build & Deploy: Trigger Cloud Build pipelines.
• Log Streaming: Stream logs from Cloud Run services.
• Database Access: Query Spanner (safe, read-only mode for dev) directly.

4. Workspace Management

• Switch Workspace: Easily toggle between olympus-cloud-gcp and other repos.
• Session History: View past conversations with AI agents.

---

Commands Reference

Command ID	Title	Description
olympus.connect	Olympus: Connect	Connect to the ACP server.
olympus.chat.open	Olympus: Open Chat	Open the AI agent chat sidebar.
olympus.search.semantic	Olympus: Semantic Search	Search codebase by meaning.
olympus.build.trigger	Olympus: Trigger Build	Start a Cloud Build for the current service.
olympus.logs.stream	Olympus: Stream Logs	Tail logs for the current service.

---

Configuration

Edit your settings.json:

{
  "olympus.acpEndpoint": "wss://acp.dev.api.olympuscloud.ai",
  "olympus.modelPreference": "claude-sonnet-4-5",
  "olympus.autocontext": true
}

---

Troubleshooting

"Connection Refused"

• Ensure you are on the VPN (if required).
• Check your internet connection.
• Verify olympus.acpEndpoint is correct.

"Authentication Failed"

• Run Olympus: Logout and then Olympus: Connect to refresh your token.