Install and configure in VS Code

Step 1 — Install the extension

1. Download the latest VSIX using the button above.
2. Open VS Code.
3. Open Extensions (⇧⌘X), click ⋯, then Install from VSIX….
4. Select the downloaded .vsix file.
5. Reload VS Code when prompted.

Step 2 — Configure settings

1. Open Settings (⌘,) and search for Officeless Code Intelligence.
2. Set Api Base Url to http://127.0.0.1:8765.
3. Set Chat Profile to devops for DevOps Central / platform prompts, or general for everyday coding.
4. Or edit settings.json:

   {
     "officelessCodeIntelligence.apiBaseUrl": "http://127.0.0.1:8765",
     "officelessCodeIntelligence.enableInlineCompletion": true,
     "officelessCodeIntelligence.contextLines": 50,
     "officelessCodeIntelligence.chatProfile": "general"
   }

Step 3 — Verify bridge and inline completion

1. Open the Command Palette with ⇧⌘P (Shift + Command + P).
2. Type Officeless: Check Bridge Status and press Enter. You should see a notification that the bridge is running on port 8765.
3. Open any code file in your workspace and start typing — inline completions should appear after a short pause (ghost text you accept with Tab).
4. Select a block of code, open the Command Palette again, and try Officeless: Explain Selection or Officeless: Refactor Selection. The reply opens in a new editor tab beside your file.

Step 4 — Open integrated terminal chat

Officeless: Open Terminal Chat launches the bundled Codex-style CLI inside a VS Code integrated terminal — no separate Terminal.app window needed.

1. Open the Command Palette: ⇧⌘P.
2. Start typing Officeless: Open Terminal Chat (short filter: terminal chat).
3. Select Officeless: Open Terminal Chat and press Enter.
4. VS Code opens (or focuses) an integrated terminal tab named Officeless Chat at the bottom of the window.
5. The extension starts the CLI automatically. You should see a banner like Officeless Code Intelligence · terminal chat and a prompt waiting for input.
6. The terminal uses your first workspace folder as the working directory and picks up Chat Profile from Step 2 (general or devops).

Tip: open the integrated terminal panel with ⌃` (Control + backtick) if it is hidden. For a standalone terminal outside VS Code, see the Codex integration guide.

Step 5 — Test coding

Use these quick checks to confirm inline completion, terminal chat, and selection commands are working against the local bridge.

A — Inline completion

1. Create a new file, e.g. test.ts.
2. Type function add(a: number, b: number) and pause — ghost-text completion should suggest the function body.
3. Press Tab to accept a suggestion.

B — Terminal chat (in Officeless Chat terminal)

After opening terminal chat (Step 4), type prompts and press Enter:

/status
Write a TypeScript function that checks if a string is a valid IPv4 address
Explain how Express middleware works for error handling
/file package.json
Summarize the npm scripts in this repo

REPL helpers: /help, /clear, /file path, /exit. With chatProfile: devops, try platform prompts like "Which make target deploys secret-broker on prod-vas?"

C — Ask about selected code

1. Select a function or block in an open file.
2. Command Palette → Officeless: Ask About Selection.
3. Type a question such as "What bugs might this have?" or "Suggest unit tests" — the answer opens in a Markdown tab beside your editor.

D — Direct API check (optional)

curl -X POST http://127.0.0.1:8765/v1/chat \
  -H 'Content-Type: application/json' \
  -d '{
    "message": "Write a bash one-liner to list Kubernetes pods in all namespaces",
    "language": "bash",
    "filePath": "",
    "context": "",
    "profile": "general",
    "history": []
  }'

Developer install (optional)

git clone https://bitbucket.org/jojocoders/officeless-intelligence-runtime.git
cd officeless-intelligence-runtime
npm run extension:install
# Open extension/ in VS Code and press F5