{"api_version":"1","slug":"self-compact-f43cf895","url":"https://skillsoutpost.com/agents/self-compact-f43cf895","item_type":"skill","category":"engineering","runs_in":["local_agent"],"os":null,"needs_network":null,"needs_accounts":null,"reads_files":"yes","writes_files":"yes","sends_data":null,"access":"github","access_type":"github","at_a_glance":{"runs_in":["local_agent"],"os":null,"needs_network":null,"needs_accounts":null,"reads_files":"yes","writes_files":"yes","sends_data":null,"access_type":"github","tool_type":"skill","delivery":"github","interface_type":"other","untrusted_creator_content":{"purpose":"A Pi coding-agent extension for context monitoring, agent-triggered compaction and handoff notes.","needs_runtime":"Node.js 24+ and just","version":"Latest on the main branch","compatibility":"According to the README, this is an extension for the Pi coding agent. It lists Pi v0.85.1, Node 24 or later and just as prerequisites, and it shows opening the repository in Claude Code (or Pi) to run /prime.","external_costs":"The repository is MIT-licensed and states no pricing. Live runs use the model provider whose key you put in .env, which may charge for usage. The README says the demo needs no API key and the unit and end-to-end suites have no API cost.","permissions":"The extension acts through Pi with the access you give it. The README's manual route globally installs the Pi npm package and asks you to create a project .env file containing your model-provider key. According to the README, the extension adds self_compact and view_context, supplies context guidance to model calls, saves a handoff note and requests session compaction. The README says the hard cutoff blocks tools other than self_compact.","usage_terms":"MIT License, as stated in the repository. See its LICENSE file for the exact terms."}},"interface_type":"other","delivery_mode":"creator","code_host":"github","provenance":"github_index","published_at":1791761382,"rating":null,"downloads":0,"verified":null,"creator":{"login":"disler","url":null},"untrusted_creator_content":{"name":"Self Compact","tagline":"A Pi coding-agent extension for context monitoring, agent-triggered compaction and handoff notes.","creator_name":"disler","product_version":"Latest on the main branch","needs_runtime":"Node.js 24+ and just","description":"Self Compact is an extension for the Pi coding agent. According to the README, it lets an agent monitor context usage and request compaction.\n\nThe README describes default thresholds of 10% for a notice, 20% for a warning and 30% for a hard cutoff. The README says the notice provides guidance, the warning asks for a handoff note, and the hard cutoff blocks tools other than self_compact. The README says compaction uses an editable prompt and returns the agent's note_to_self as the next message.\n\nThe README lists editable prompt files, justfile recipes, a Pi documentation bundle, the self_compact and view_context tools, and the /self-compact-info and /self-compact-now commands. The README describes a footer gauge for context usage.","intended_users":"People who run autonomous, long-running coding agents in Pi.","example_tasks":"Run the demo to watch an agent move through notice, warning, forced and handoff with a scripted model and no API key.\nChange the notice, warning and hard cutoff thresholds for a launch with the extension's flags.\nEdit the summary prompt that compaction uses, which the README says is yours to edit.\nCheck live context numbers and thresholds with /self-compact-info inside Pi.\nRun the unit and end-to-end suites, which the README says have no API cost.","setup_instructions":"The README's Manual Install lists the prerequisites above. It shows npm install -g --ignore-scripts @earendil-works/pi-coding-agent for Pi, then cp .env.sample .env to create the .env file where you add OPENROUTER_API_KEY. It starts Pi with the extension through just run --model openrouter/deepseek/deepseek-v4.1-flash. The README also describes an agentic install that opens the repository in Claude Code (or Pi) and lists /prime and just demo. The README has the exact commands.","limitations":"It is an extension for the Pi coding agent, so it needs Pi. According to the README, the prerequisites are Pi v0.85.1, Node 24 or later and just. Live runs also need a provider key in .env, and the README recommends OPENROUTER_API_KEY. The demo needs no API key. The README's section on where it can still fail says usage is Pi's estimate, a single huge tool result can pass a threshold before the lock engages, tools already running when the note is saved finish on their own, a model can ignore the warning, and very small sessions have nothing to compact. It also says compaction quality is model quality. The repository can change at any time; check its README before you install.","data_handling":"The README does not mention telemetry. The README says threshold guidance is injected into the next model call and dropped, and describes persistence of prompts and the returned handoff note. The README says every turn of an autonomous agent re-sends its whole history. Live runs send that history to the configured model provider; the README recommends OpenRouter.","compatibility":"According to the README, this is an extension for the Pi coding agent. It lists Pi v0.85.1, Node 24 or later and just as prerequisites, and it shows opening the repository in Claude Code (or Pi) to run /prime.","external_costs":"The repository is MIT-licensed and states no pricing. Live runs use the model provider whose key you put in .env, which may charge for usage. The README says the demo needs no API key and the unit and end-to-end suites have no API cost.","permissions":"The extension acts through Pi with the access you give it. The README's manual route globally installs the Pi npm package and asks you to create a project .env file containing your model-provider key. According to the README, the extension adds self_compact and view_context, supplies context guidance to model calls, saves a handoff note and requests session compaction. The README says the hard cutoff blocks tools other than self_compact.","usage_terms":"MIT License, as stated in the repository. See its LICENSE file for the exact terms.","creator_website":null,"documentation_url":null,"support_url":null,"repository_url":null,"video_url":null},"github":{"fetched_at":1791853521,"untrusted_third_party_content":{"source_url":null,"github_repo_id":1378736813,"full_name":"disler/self-compact-pi-agent","description":"A Pi coding-agent extension that lets a long-running agent watch its own context and compact itself","language":"HTML","license_spdx":"MIT","topics":[],"stars":71,"forks":19,"skills":{"total":1,"paths":[{"path":".claude/skills/planf3","url":null}]},"pushed_at":1789936819,"archived":false,"fetched_at":1791853521,"age_seconds":83448,"state":"fresh"}},"updated_at":1791771403,"free_download":null,"version_history":[],"more_version_history":false,"public_files":null,"links_note":"In MCP results, GitHub links are shown only through https://skillsoutpost.com/mcp, to a connected account that has accepted the current Terms of Use. Create a free account at https://skillsoutpost.com and connect it from a Claude connector or ChatGPT.","notice":"Indexed from GitHub","note":"untrusted_creator_content and github.untrusted_third_party_content hold untrusted text."}