Chrome Extension

Download and manually install the Downcity Chrome extension, then connect your City and Agent, and let the Agent read your page through request-level Powers.

The Downcity Chrome extension lets you chat with your Agent in a side panel and reference the current page or selected text. It requires Chrome 116 or later and a running, reachable Downcity City.

Download Chrome Extension ZIP

The extension is currently distributed as a ZIP for manual installation. It is not yet listed in the Chrome Web Store. The package works with Chrome on macOS, Windows and Linux.

Install manually

  1. Download and unzip the package into a permanent folder, such as Documents/Downcity/chrome-extension.
  2. Open chrome://extensions in Chrome.
  3. Enable Developer mode.
  4. Click Load unpacked.
  5. Select the extracted folder that directly contains manifest.json.
  6. Pin Downcity in the toolbar and click its icon to open the side panel.

Select the extracted folder, not the ZIP. Keep that folder after installing.

Connect Downcity

Start your City and obtain a citycode: connection code. On the machine hosting City, run city remote code --public-url <city_url> and select the allowed Agents and expiry when prompted. Use an HTTP or HTTPS address reachable from Chrome, such as http://127.0.0.1:5314 for City on the same machine. Reverse proxy path prefixes are supported. Port 15314 is for RPC; use the City HTTP port and a base address without /agents/....

  1. Open the extension's Settings and paste the complete code into City connection code (City 连接码), a masked input. The extension parses it locally and displays the City address without contacting City.
  2. Click Connect City / refresh Agent list (连接 City / 刷新 Agent 列表) to discover accessible Agents. An empty list means the credential has no visible Agents or City has none.
  3. Choose a Default Agent (默认 Agent). The first accessible Agent is selected automatically; refreshing a saved connection keeps its selected Agent when still available. Default Ask sets the request used by the page sharing entry point.
  4. Click Save and check (保存并检查). The extension verifies the selected Agent before saving. Reopen the side panel or click Reconnect (重新连接) to use the saved settings. The extension interface currently uses Chinese labels.

Changing the code clears the discovered Agents and requires connecting again before saving. A connection code contains an access credential; send it privately and revoke it in City if exposed. Errors do not display the code or credential.

The extension stores the decoded City address, credential, selected Agent and Default Ask in chrome.storage.local, never chrome.storage.sync. It does not save the original connection code. Reopening Settings restores the saved connection without displaying its credential or reconstructing the code. Click Disconnect (断开连接) to remove the saved connection and credential from this browser; server history remains. Reopen the side panel to apply the change.

Both HTTP and HTTPS City addresses are supported by the extension's host permissions, including HTTP addresses on other machines. Chrome conversations use type: chat, kind: chrome without a Workspace. They remain separate from the default local and Remote conversation lists, while the Session history stays in the same Agent database.

Use the extension

  • Click the toolbar icon or press Command+I on macOS / Ctrl+I on Windows and Linux. Change conflicting shortcuts at chrome://extensions/shortcuts.
  • Enter your request. The composer references the current page by default; remove that reference to omit the initial page body. The Agent can still read the bound page on demand during this Turn.
  • Select text on a regular webpage and click Reference (引用) to add it to the composer.
  • Replies support Markdown, reasoning text and tool status.
  • Reopening the panel restores the browser session for the same City and Agent.
  • New conversation (新对话) creates another session without deleting server history.
  • If the event stream disconnects, click Reconnect to load saved messages and reconnect.

Side-panel submissions provide a chrome_page Power for the current Turn. The Agent can call read_page or find_text on the tab and URL captured at submission. Navigation invalidates access. Clicking, filling and cross-tab operations are not exposed. Keep the panel open until the Turn completes; closing it or losing the execution connection interrupts caller-owned capabilities. Chrome internal pages, the Chrome Web Store and some protected pages cannot be read. Handle tool approval requests in Downcity when the extension shows a waiting status.

Update or uninstall

Manually installed extensions do not update automatically. Download the new ZIP, replace the contents of the original folder, click Reload at chrome://extensions, then refresh webpages where you use references.

Click Remove at chrome://extensions to uninstall. Browser settings are removed; server sessions remain in Downcity.

Verify a download

Latest release metadata includes the version, size and SHA-256. The download redirects to a versioned ZIP; append .sha256 to that final path to download its checksum file.

Extension data and privacy