GitHub - piqoni/pi-piqo: A good invisible interface to agents · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
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
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
piqoni
pi-piqo
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star<br>21
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>19 Commits<br>19 Commits
test_dir
test_dir
LICENSE
LICENSE
README.md
README.md
index.ts
index.ts
package.json
package.json
View all files
Repository files navigation
Piqo — Pi Extension
A chat-less way to collaborate with your favorite LLM models (remote or local), directly from your files and from any editor. The output is stored automatically into your files.
It is a simple file-watcher extension for pi triggered on-save, which continously monitors directories for @piqo markers and uses the LLM to generate content inline.
Might be useful for keeping notes, writing tasks, researching topics, etc.
Random Example:<br>If you write the following (highlighted line) and save the file:
You will get something like (using gpt-5.4-mini):
How It Works
You start pi with the piqo extension and specify directories to watch
Piqo recursively watches those directories for file changes
When a file contains one or more @piqo markers, it reads the file, gathers context around all markers, and sends them to pi's LLM in one request
The LLM fulfills each prompt and removes the human prompt line/tag from the file
Usage
If you have Pi installed, you are one command away from using it:
# Load it directly from npm (or alternatively github repo url)<br>pi -e npm:pi-piqo --dir=/path/to/your/project
Other options:
# Or if you want to reference it locally, git clone the repo and reference it directly<br>pi -e ./piqo-extension --dir /path/to/your/project
# Watch multiple directories<br>pi -e ./piqo-extension --dir /path/to/dir1,/path/to/dir2
# Headless mode (no TUI)<br>pi -e ./piqo-extension --dir /path/to/project -p "Start piqo watcher"
Marker Format
In any text file within the watched directories, add:
">@piqo
The LLM will process it and replace/remove the prompt so the file becomes:
... generated content ...
Examples
In a Python file:
# @piqo add a function to parse CSV files and return a list of dicts
# Becomes generated code with the @piqo prompt removed
In a Markdown file:
@piqo write a summary of REST API best practices
Becomes generated content with the @piqo prompt removed
In a config file:
# @piqo add sensible default nginx config for a Node.js app
# Becomes generated config with the @piqo prompt removed
Behavior Details
Debounce : File changes are debounced at 500ms per file to avoid duplicate processing
Initial scan : On startup, piqo scans all watched directories for existing markers
Ignored paths : Hidden files/dirs, node_modules, .git are automatically skipped
Text files only : Only processes common text file extensions (.ts, .js, .py, .md, .txt, etc.)
Installation
To install it for your Pi globally:
pi install npm:pi-piqo
But then to use it, simply run pi but with --dir option of the directory that you want to monitor. See usage section for more options.
pi --dir=/path/of/your/project
About
A good invisible interface to agents
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
21<br>stars
Watchers
watching
Forks
fork
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
TypeScript<br>100.0%
You can’t perform that action at this time.