GitHub - peterp/pi-sidequest

Source: https://github.com/peterp/pi-sidequest

Search code, repositories, users, issues, pull requests...

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

- [x] Include my email address so I can be contacted

Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel Create saved search

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

peterp/**pi-sidequest**Public

- NotificationsYou must be signed in to change notification settings

- Fork 3

- Star 43

- Code

- Issues 0

- Pull requests 0

- Actions

- Projects

- Security and quality 0

- Insights

Additional navigation options

- Code

- Issues

- Pull requests

- Actions

- Projects

- Security and quality

- Insights

[](https://github.com/peterp/pi-sidequest)

peterp/pi-sidequest

main

Branches Tags

[](https://github.com/peterp/pi-sidequest/branches)[](https://github.com/peterp/pi-sidequest/tags)

Go to file

Code

Open more actions menu

Folders and files

| Name | Name | Last commit message | Last commit date | | --- | --- | --- | --- | | ## Latest commit ## History 13 Commits [](https://github.com/peterp/pi-sidequest/commits/main/)13 Commits | | [media](https://github.com/peterp/pi-sidequest/tree/main/media "media") | [media](https://github.com/peterp/pi-sidequest/tree/main/media "media") | | | | [src](https://github.com/peterp/pi-sidequest/tree/main/src "src") | [src](https://github.com/peterp/pi-sidequest/tree/main/src "src") | | | | [.gitignore](https://github.com/peterp/pi-sidequest/blob/main/.gitignore ".gitignore") | [.gitignore](https://github.com/peterp/pi-sidequest/blob/main/.gitignore ".gitignore") | | | | [LICENSE](https://github.com/peterp/pi-sidequest/blob/main/LICENSE "LICENSE") | [LICENSE](https://github.com/peterp/pi-sidequest/blob/main/LICENSE "LICENSE") | | | | [README.md](https://github.com/peterp/pi-sidequest/blob/main/README.md "README.md") | [README.md](https://github.com/peterp/pi-sidequest/blob/main/README.md "README.md") | | | | [package.json](https://github.com/peterp/pi-sidequest/blob/main/package.json "package.json") | [package.json](https://github.com/peterp/pi-sidequest/blob/main/package.json "package.json") | | | | View all files |

Repository files navigation

- README

- MIT license

More items

Sidequest

[](https://github.com/peterp/pi-sidequest#sidequest)

Sidequest gives Pi a side channel: ask context-aware questions without pulling the main conversation off track.

Think of it as a better `/btw`: grounded in the active Pi session, threaded, persistent, and tool-capable.

Demo

[](https://github.com/peterp/pi-sidequest#demo)

![Image 2: Sidequest demo](https://raw.githubusercontent.com/peterp/pi-sidequest/main/media/sidequest-demo.webp)

Download the MP4 demo

Install

[](https://github.com/peterp/pi-sidequest#install)

From npm:

undefinedshell pi install npm:pi-sidequest undefined

From GitHub:

undefinedshell pi install git:github.com/peterp/pi-sidequest undefined

For local development:

undefinedshell pi -e /absolute/path/to/pi-sidequest undefined

Or link `src/` as an auto-discovered extension directory:

undefinedshell ln -s /absolute/path/to/pi-sidequest/src ~/.pi/agent/extensions/sidequest undefined

Use

[](https://github.com/peterp/pi-sidequest#use)

Open Sidequest inside Pi:

``` /sidequest ```

Default quake console keys:

``` § ~ ```

Sidequest has two focus areas:

- selection: choose root or a thread

- prompt: type and ask the next question

Press `Tab` to move between them. The inactive area shows `[tab]` in its border.

Configure the Quake key

[](https://github.com/peterp/pi-sidequest#configure-the-quake-key)

Use an env var:

undefinedshell PI_SIDEQUEST_QUAKE_KEY='`' undefined

or a config file:

undefinedjson // ~/.pi/agent/sidequest.json { "quakeKey": "`" } undefined

Multiple keys are supported:

undefinedshell PI_SIDEQUEST_QUAKE_KEYS='§,~,alt+s' undefined

undefinedjson { "quakeKeys": ["§", "~", "alt+s"] } undefined

Tools

[](https://github.com/peterp/pi-sidequest#tools)

Sidequest runs its own isolated, tool-capable Pi worker. By default it enables:

``` read, grep, find, ls, sidequest_web_search, sidequest_web_fetch ```

Override the allowlist:

undefinedshell PI_SIDEQUEST_TOOLS='read,grep,find,ls,sidequest_web_search,sidequest_web_fetch' undefined

`sidequest_web_search` uses Brave Search when `BRAVE_SEARCH_API_KEY` is set. Otherwise it falls back to DuckDuckGo HTML search. `sidequest_web_fetch` fetches public HTTP(S) pages and extracts readable text.