Project Context Sync

v1.0.0

Automatically updates PROJECT_STATE.md after each commit with recent git info and optional AI-generated summaries to track project status and next steps.

3· 2.8k·8 current·8 all-time
byJoseph Sagiv@joe3112
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Suspicious
high confidence
Purpose & Capability
The skill's name and files match its stated purpose (install a post-commit hook that keeps PROJECT_STATE.md up-to-date). However, the shipped scripts read a Clawdbot gateway config (~/.clawdbot/clawdbot.json) and may use a CLAWDBOT_TOKEN — these runtime interactions are related to the AI-summary feature but are not declared in the skill's metadata (no required env vars or binaries are listed).
!
Instruction Scope
The runtime script (update-context.sh) collects repository metadata (commit messages, changed files, diff stats) and, when AI mode is enabled, will send that context to a local HTTP gateway endpoint (/v1/chat/completions) with a bearer token read from the user's Clawdbot config or from environment (CLAWDBOT_TOKEN). That behavior is within the feature's scope, but it reads a user config file and a secret token (undocumented in metadata) and transmits repository context to a network endpoint — potential data exposure if the gateway is misconfigured or forwards requests externally.
Install Mechanism
No external downloads or remote installs are performed; install.sh copies provided scripts into the repository's .git/hooks and writes .project-context.yml and PROJECT_STATE.md. This is expected for a hook-based tool, but it does modify repo hooks and .gitignore. The install script also uses sed -i '' (BSD sed) which may be platform-specific.
!
Credentials
skill.json declares no required env vars or binaries, but update-context.sh expects git, curl, and (optionally) jq and reads ~/.clawdbot/clawdbot.json or CLAWDBOT_TOKEN for a bearer token. The token read from the user's home config is effectively a secret; requesting/using it is relevant to AI summaries but the metadata doesn't declare that requirement or ask for user confirmation, so there's a mismatch.
Persistence & Privilege
always is false and the skill only installs a per-repository post-commit hook (no system-wide always-on flag). The hook runs update-context.sh in the background on each commit. It does not modify other skills or global agent settings.
What to consider before installing
What to check before installing: - Review the scripts locally (install.sh, update-context.sh, post-commit-hook.sh). The installer will modify .git/hooks/post-commit and write .project-context.yml and PROJECT_STATE.md into the repo. - Understand AI mode: if ai_summary: true, the hook may read ~/.clawdbot/clawdbot.json or the CLAWDBOT_TOKEN env var and POST commit context (commit messages, changed filenames, diff stats) to http://localhost:<port>/v1/chat/completions with that bearer token. Confirm your Clawdbot gateway is configured to bind only to loopback and is not proxying requests to an external/untrusted service. - Secrets: the script reads a token from your home config — treat that as sensitive. If you don't want any tokens read or network calls, set ai_summary: false in .project-context.yml before installing. - Tooling: the scripts use git, curl, and optionally jq; ensure those are available. Note sed -i '' is BSD/macOS style and may not work unchanged on Linux (the install/uninstall scripts use it). - Test safely: install in a disposable/test repository first to observe behavior. Make a commit and inspect PROJECT_STATE.md and whether any network calls occur (e.g., run update-context.sh manually and watch curl). - Uninstall: uninstall.sh will attempt to remove the hook or the appended lines; it leaves PROJECT_STATE.md and .project-context.yml in place (remove manually if desired). Given the undeclared access to a local token file and the potential to transmit repository information, proceed only if you trust the code and your local Clawdbot gateway configuration. If you want to be conservative, disable ai_summary or inspect/modify update-context.sh to remove or alter the network call before installing.

Like a lobster shell, security has layers — review code before you run it.

latestvk976bcfb1wsgpx61m57821yey9805x3z

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Comments