{"id":51168938,"url":"https://github.com/ygncode/pi-sessions-viewer","last_synced_at":"2026-06-26T22:31:05.056Z","repository":{"id":356083535,"uuid":"1220537897","full_name":"ygncode/pi-sessions-viewer","owner":"ygncode","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-06T14:03:09.000Z","size":88,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-06T15:48:06.094Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ygncode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-25T02:33:06.000Z","updated_at":"2026-05-06T14:08:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ygncode/pi-sessions-viewer","commit_stats":null,"previous_names":["ygncode/pi-sessions-viewer"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ygncode/pi-sessions-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygncode%2Fpi-sessions-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygncode%2Fpi-sessions-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygncode%2Fpi-sessions-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygncode%2Fpi-sessions-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ygncode","download_url":"https://codeload.github.com/ygncode/pi-sessions-viewer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygncode%2Fpi-sessions-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34835779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-26T22:31:04.316Z","updated_at":"2026-06-26T22:31:05.050Z","avatar_url":"https://github.com/ygncode.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pi-sessions-viewer\n\nA local web viewer for [pi](https://pi.dev) coding agent sessions.\n\nBrowse, search, and share all your pi sessions from a browser. Renders sessions using the same HTML/CSS as pi's `/export` command, with live incremental updates as you chat.\n\n## Features\n\n- **Session browser** - Grid view of all sessions, grouped by project\n- **Tree navigation** - Full session tree with filters (same UI as `/export`)\n- **Live updates** - New messages append without page refresh\n- **Follow mode** - Auto-scrolls to latest message; pauses when you scroll up to read history\n- **Share** - Create secret GitHub Gists directly from the browser\n- **`/view` command** - Type `/view` inside pi to open the current session\n\n## Install\n\nRequires [Go](https://go.dev) 1.21+.\n\n```bash\ngit clone https://github.com/ygncode/pi-sessions-viewer.git\ncd pi-sessions-viewer\ngo build -o pi-sessions-viewer .\n\n# Put on PATH\nsudo cp pi-sessions-viewer /usr/local/bin/\n# or\ncp pi-sessions-viewer ~/.pi/agent/bin/\n```\n\n## Usage\n\n```bash\n# Start server (default port 27183)\npi-sessions-viewer\n\n# Start and open browser\npi-sessions-viewer -o\n\n# Custom port\npi-sessions-viewer -p 8080\n```\n\nThen open http://localhost:27183.\n\n## Auto-start on login (macOS)\n\n```bash\ncp com.pi-sessions-viewer.plist ~/Library/LaunchAgents/\nlaunchctl load ~/Library/LaunchAgents/com.pi-sessions-viewer.plist\n```\n\nThe viewer starts automatically on boot and runs in the background.\n\n## Pi integration\n\n### `/view` command\n\nInstall the extension to add a `/view` command inside pi:\n\n```bash\ncp view-sessions.ts ~/.pi/agent/extensions/\n```\n\nRestart pi (or run `/reload`). Then type `/view` while in a session to open it in your browser.\n\n### Skill\n\nInstall the skill so pi suggests the viewer when relevant:\n\n```bash\ncp -r skill ~/.pi/agent/skills/pi-sessions-viewer\n```\n\n## Sharing sessions\n\nOn any session page, click **Share** in the top-right to create a secret GitHub Gist.\n\nRequirements:\n- `gh` CLI installed (`brew install gh`)\n- Logged in (`gh auth login`)\n\nThe share produces:\n- A secret gist URL\n- A preview URL at `https://pi.dev/session/#\u003cgistId\u003e`\n\nShared gists are static snapshots and do not auto-update.\n\n## How it works\n\nSessions are read from `~/.pi/agent/sessions/` as JSONL files. The server:\n\n1. Parses each `.jsonl` session file\n2. Generates HTML using pi's export templates (embedded in the binary)\n3. Watches files for changes and pushes SSE events to the browser\n4. The browser fetches new entries via `/api/session` and appends them incrementally\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fygncode%2Fpi-sessions-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fygncode%2Fpi-sessions-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fygncode%2Fpi-sessions-viewer/lists"}