Argos Bridge
Connects VS Code to Argos, the macOS desktop companion, so Argos can show you around your codebase. Ask Argos about the code in front of you and it opens the right file, highlights the exact lines it is talking about, finds where things are defined and used, and explains what you're looking at.
This extension is only the bridge. The explaining and touring happens in the Argos app.
Features
- Guided tours. Argos opens files, scrolls to the right place and highlights the lines it is explaining.
- Context-aware answers. Argos can see which file and lines you have selected, so you can say "what does this do?"
- Real code intelligence. Definitions, references, symbols and hover info come from VS Code's own language features, so answers match what your editor knows.
- Multiple windows. Each VS Code window gets its own connection. Argos follows whichever window you last used.
- Status bar indicator.
✓ Argos when connected, ⊘ Argos when not. Click it to check the connection.
Privacy and safety
- Read-only. The bridge can open files, move the cursor, highlight and reveal lines, and ask VS Code for definitions, references, symbols and hover text. It has no code that edits or saves files, runs commands, starts tasks or uses the terminal.
- Local-only. It listens on
127.0.0.1 (ports 7823–7832) and never on your network, so there is no firewall prompt and nothing is reachable from other machines. It makes no network requests of its own.
- Workspace-scoped. Requests for files outside the folders you have open are refused.
- What leaves VS Code. The Argos app on your Mac receives the workspace name and path, the active file and selection, the list of files, and the code snippets it asks for. What Argos does with them afterwards is set by the Argos app and its settings.
Requirements
- macOS with the Argos desktop app installed and running.
- VS Code 1.85 or later.
- A project folder open in VS Code.
Setup
- Install Argos Bridge from the Extensions view (search "Argos Bridge").
- Open (or reload) a VS Code window with your project folder.
- Start the Argos app. It finds VS Code by itself within a few seconds.
- Check that the status bar shows ✓ Argos. If it doesn't, click it or run Argos: Check Connection.
No settings or configuration are needed.
Commands
| Command |
What it does |
| Argos: Check Connection |
Tells you whether Argos is connected to this window, which project is open and which file is active. |
| Argos: Test Highlight (Debug) |
A developer check for the highlight pipeline. It only works inside the Argos source repository. |
Troubleshooting
- Status bar shows
⊘ Argos. Make sure the Argos app is running. It reconnects on its own within a few seconds. If it still doesn't, reload the window (Developer: Reload Window).
- "Every Argos port is busy". Up to 10 VS Code windows can connect at once (ports 7823–7832). Close a window you're not using and reload this one. Check that no other program is using those ports:
lsof -iTCP:7823-7832 -sTCP:LISTEN.
- Argos talks about the wrong window. Argos follows the window you focused last. Click into the window you want.
- "No folder is open". Open a folder (File → Open Folder…). Argos only works with files inside an open workspace.
- Remote, WSL or container windows. The bridge runs on your local machine, where Argos runs, as a UI extension. Some remote setups may not expose remote files to it.
License
MIT
| |
