copilot.tools 1.0.0

package/skills/history/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: history
+description: Lists all Copilot chat sessions with message count, tokens consumed, cost, and totals. Triggered when the user types `/history`.
+user-invocable: true
+---
+
+Copyright (C) 2026 Celestial Consulting Ltd
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+# `/history` Command
+
+When the user types `/history`, list all chat sessions from Copilot with their metadata and a total summary row.
+
+## Behavior
+
+1. Run `copilot-history` (installed globally via `npm install -g copilot.history`)
+2. Extract session metadata from Copilot's SQLite database: timestamp, tokens consumed, estimated cost, model used
+3. Present as a formatted table with columns: Date/Time, Title, Messages, Tokens, Cost, Model
+4. Include a TOTAL row at the bottom summarizing all sessions
+
+### Important: No-sessions handling
+If no sessions exist in the database, that's **normal** for a fresh Copilot install. Simply report "No sessions found." and stop.
+
+## Implementation Notes
+- Uses `better-sqlite3` npm package to query the SQLite database (synchronous, performant)
+- Works on Windows, macOS, and Linux (database location is platform-aware)
+- The skill is installed globally — works in any workspace
+- Session data persists across VS Code restarts
+- Token counts and costs reflect actual Copilot usage from the session store
+
+## Database Location
+- **Windows**: `C:\Users\<username>\AppData\Roaming\Code\User\globalStorage\github.copilot-chat\session-store.db`
+- **macOS**: `~/Library/Application Support/Code/User/globalStorage/github.copilot-chat/session-store.db`
+- **Linux**: `~/.config/Code/User/globalStorage/github.copilot-chat/session-store.db`

package/skills/snapshot/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: snapshot
+description: Toggle automatic pre-edit file snapshotting on or off. Triggered by /snapshot on and /snapshot off.
+user-invocable: true
+---
+
+Copyright (C) 2026 Celestial Consulting Ltd
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+# `/snapshot` Command
+
+When the user types `/snapshot on`, `/snapshot off`, or `/snapshot status`, manage automatic file backup before edits.
+
+## Behavior
+
+### `/snapshot on`
+1. Detect the platform from the shell environment:
+   - **Windows**: `$env:OS` contains `Windows_NT`, shell is `powershell.exe`
+   - **macOS/Linux**: detect by the absence of `$env:OS`, shell is typically `bash` or `zsh`
+2. Check if `.git` exists in the workspace root:
+   - **Windows**: `if (Test-Path .git) { ... }`
+   - **macOS/Linux**: `if [ -d .git ]; then ...`
+3. **If Git repo exists**: reply "This workspace has a Git repo — snapshotting is not needed. Use `git restore <file>` to undo changes."
+4. **If no Git repo**: create `_snapshots/` directory, write a note to persist `snapshot_enabled=true`, then confirm to the user.
+5. From this point forward, before editing any **existing** file:
+   - **Ensure `_snapshots/` exists** — create it if missing (don't assume it still exists from init time)
+     **Windows**: `if (-not (Test-Path '_snapshots')) { New-Item -ItemType Directory -Path '_snapshots' -Force | Out-Null }`
+     **macOS/Linux**: `mkdir -p _snapshots`
+   - **Snapshot the file** using the appropriate command for the detected platform:
+     **Windows (PowerShell):**
+     ```powershell
+     $ts = Get-Date -Format 'yyyy-MM-dd_HH-mm-ss'
+     $base = [System.IO.Path]::GetFileNameWithoutExtension('<file>')
+     $ext  = [System.IO.Path]::GetExtension('<file>')
+     Copy-Item '<file>' "_snapshots/$base.$ts$ext"
+     ```
+     **macOS/Linux (Bash):**
+     ```bash
+     ts=$(date +%Y-%m-%d_%H-%M-%S)
+     base=$(basename "<file>" | sed 's/\.[^.]*$//')
+     ext=$(echo "<file>" | sed 's/.*\.//')
+     cp "<file>" "_snapshots/${base}.${ts}.${ext}"
+     ```
+   - **Retry on failure**: if the copy command fails (non-zero exit), recreate `_snapshots/` and retry exactly once.
+   - **Final failure**: if the retry also fails, report the error to the user and **do NOT proceed with the edit** — this is a snapshot contract violation.
+   - Result example: `foo.py` → `_snapshots/foo.2026-06-20_11-30-00.py`
+   - Do NOT snapshot brand-new files being created for the first time
+
+### `/snapshot off`
+1. Write a note to persist `snapshot_enabled=false`.
+2. Reply "Snapshotting is now off. Existing snapshots in `_snapshots/` have been preserved."
+3. Stop snapshotting before future edits.
+
+### `/snapshot status`
+1. Read the snapshot-enabled note.
+2. Count files in `_snapshots/` (if directory exists).
+3. Report: whether snapshotting is on/off, the snapshot directory exists, and file count.
+
+## Notes
+- The skill is installed globally — works in any workspace
+- Snapshot state is session-scoped — does not persist across different Copilot chat sessions
+- Use `/snapshot off` before switching to a Git-tracked project to avoid redundant copies