Wiki Viewer

Wiki Viewer opens a Paseo workspace in wiki-viewer, a local file viewer for markdown, HTML, PDFs, notebooks, office documents, and more.

Search for "Open Wiki Viewer" in the Command Center to open it in the Explorer sidebar, or add the Wiki Viewer panel to a workspace. The panel installs or updates wiki-viewer from npm when you press its button; it never downloads anything on its own. On desktop and in the browser the wiki shows inside the panel, with Open in tab for a full browser tab. On iOS and Android the panel opens it in your system browser.

Documents, images, media, data, and source files can also open in wiki-viewer inside their own file tab, whether you click them in an agent's chat or in the file tree. The first time you open a file of one of these types, Paseo asks which viewer to use; choose Wiki Viewer and Don't ask me again. Change the choice later with Open with… in the tab menu or in Settings > Files. On desktop and in the browser, Show in sidebar at the top of the tab opens the same file in the Explorer sidebar. A link to a specific line opens Paseo's own editor at that line. A file outside the workspace opens in a viewer scoped to that file's directory.

How it works

The daemon runs wiki-viewer on 127.0.0.1 and puts a small access-checking proxy in front of it. Each open link carries a random grant tied to one directory; the proxy requires a valid grant for file access and fixes the browsed root to that directory. Outside files get a new grant for their containing directory. Because a frame inside Paseo cannot keep cookies, the proxy adds a small script to each viewer page that attaches the grant to the page's own requests. A grant expires after 30 minutes without use.

Settings

Under Settings, Plugins, Wiki Viewer:

• Public URL: the base URL your devices use to reach the daemon. Empty uses http://<daemon hostname>:<port>. Set it when the daemon is reached through another name, a tunnel, or HTTPS.
• Port: the proxy port. 0 picks a free port at each start; pin it if a firewall must allow it.
• Viewer root: run an existing wiki-viewer build or source checkout instead of the managed install in ~/.paseo/wiki-viewer.

Limits

The proxy listens on all interfaces of the daemon machine and uses plain HTTP, so anyone on that network who obtains a grant URL can read that workspace until the grant expires. The managed install needs npm and tar on the daemon's PATH and is about 30 MB.