agentsky

My pi coding agent configuration package.

It includes:

• custom extensions
• custom tools
• reusable skills
• checks/themes

What's included

Extensions

Extension	Description
command-palette	Command palette overlay (/palette, Ctrl+O)
editor	Custom boxed editor UI, colored status labels, activity row
mermaid	Mermaid diagram extraction + viewer (/mermaid, Ctrl+Shift+M)
handoff	Session handoff command and extraction flow
tools	Replacement/augmented toolset (read/edit/bash/etc + subagents)
context	Context inspection command (/context)
notify	Desktop completion notifications
session-breakdown	Session log breakdown view
shell-preprocessor	Expands inline shell snippets in prompts
usage-bar	Provider usage/quota status UI
clipboard	Clipboard helpers
amp-skills	Skill-loading helpers
session-name	Auto naming support
system-prompt	Prompt shaping helpers
tool-harness	Tool wiring/runtime helpers

Skills

Skill	Description
agent-browser	Browser automation workflows
commit	Conventional-commit workflow
github	gh-based GitHub workflows
handoff	Context handoff guidance
session-query	Session search/query guidance

---

Tools extension notes

extensions/tools replaces and extends core tools.

Core file/system tools

• read, ls, edit, write (as create-file), grep, glob, bash
• undo_edit, format_file, skill

Sub-agent/specialized tools

• finder, oracle, Task, librarian, code_review, look_at
• read_web_page, web_search
• search_sessions, read_session

GitHub tools

• read_github, search_github, list_directory_github, list_repositories
• glob_github, commit_search, diff

Behavior differences

• File edits are mutex-protected where needed.
• Undo history is tracked on disk (~/.pi/file-changes/<sessionId>/...).
• Some sub-agent tools prefer configured models first, then fall back to the current model.

---

Keybindings

Pi keybindings are loaded from ~/.pi/agent/keybindings.json.

This repo includes a local template at:

• ./keybindings.json

Current default in this repo:

{
  "expandTools": [],
  "cycleModelForward": [],
  "cycleModelBackward": [],
  "selectModel": [],
  "cycleThinkingLevel": []
}

This frees Ctrl+O for the command palette and unbinds model/thinking cycling shortcuts.

Install/refresh keybindings from this repo

pnpm run setup:keybindings

This copies:

• ./keybindings.json → ~/.pi/agent/keybindings.json

After updating keybindings, run /reload in pi.

Current hotkeys snapshot (/hotkeys)

Captured from a live pi session in this repo after applying keybindings.json.

Extension hotkeys

• Ctrl+O → Open command palette
• Ctrl+Shift+M → View mermaid diagrams

Relevant built-in hotkeys

• Ctrl+T → Toggle thinking block visibility
• Ctrl+G → Edit in external editor
• Alt+Enter → Queue follow-up
• Alt+Up → Restore queued messages
• / → Slash commands
• ! / !! → Bash command shortcuts

Unbound by this repo keybindings

• expandTools
• cycleModelForward
• cycleModelBackward
• selectModel
• cycleThinkingLevel

---

Setup

Install package

pi install https://github.com/taskylizard/agentsky

Install dependencies (if using local checkout)

pnpm install

Apply keybindings template

pnpm run setup:keybindings

Reload pi

Use /reload in an active pi session.

Update

pi update

---

Development

Typecheck

pnpm run typecheck

Notes

• This package is intended for pi package loading via package.json -> pi resources.
• Keybindings are not loaded from package manifest; they must exist in ~/.pi/agent/keybindings.json.