An automated git hook that maintains a living project state document to provide instant context for AI coding agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install project-context-sync
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install project-context-sync using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Project Context Sync?
Project Context Sync is a developer utility designed to bridge the gap between git history and AI agent comprehension. By maintaining a dynamic PROJECT_STATE.md file in your repository root, it ensures that any AI agent or future developer session can instantly grasp the current status, recent changes, and upcoming objectives of a project. This utility is a core part of the Openclaw Skills ecosystem, focused on streamlining agentic workflows.
The tool operates silently in the background via a git post-commit hook. It extracts metadata from your git history and can optionally leverage LLMs to generate high-level summaries of your progress. This eliminates the cold start problem when switching between tasks or initializing new sessions, making it an essential addition for developers leveraging Openclaw Skills.
Project Context Sync Use Cases
- Transitioning between development sessions where AI agents need immediate context on recent changes.
- Onboarding new AI agents to a complex repository without manual briefing.
- Generating automated project status reports based on actual commit history and diff statistics.
- Identifying the current development focus and suggested next steps using AI-driven analysis.
How Project Context Sync Works
- A developer performs a standard git commit within the enabled repository.
- The post-commit hook triggers the Project Context Sync script automatically.
- The skill gathers git metadata including branch information, recent history, and file changes.
- If AI mode is enabled, it sends the context to a local LLM gateway for intelligent summarization.
- The skill updates the PROJECT_STATE.md file with organized sections like Current Focus and Suggested Next Steps.
Project Context Sync Setup
To enable this skill in your repository, navigate to your project folder and run the installation script from Openclaw Skills:
cd /path/to/your/repo
/path/to/skills/project-context-sync/scripts/install.sh
Alternatively, if the skill is in your system path, you can use:
project-context-sync install
This will install the post-commit hook, create a .project-context.yml configuration file, and generate the initial PROJECT_STATE.md document.
Project Context Sync Data Schema & Taxonomy
The skill manages data through a configuration file and a generated state document as described below:
| File/Component | Purpose |
|---|---|
.project-context.yml |
YAML configuration for AI toggles, commit limits, and active sections. |
PROJECT_STATE.md |
The output file containing the last commit, recent changes, and AI insights. |
.git/hooks/post-commit |
The execution trigger that runs the sync process after every commit. |
Note that PROJECT_STATE.md is added to your .gitignore by default to ensure it remains a fresh, local context for the current environment.
Project Context Sync Advanced Features
- AI Summary Mode: Leverages the Clawdbot Gateway HTTP API to generate intelligent insights from your code changes.
- Manual Update Trigger: Refresh your project state without a commit using the
update-context.shscript. - Custom Sections: Define exactly what information appears in your state file, including diff stats and AI-suggested next steps.
- Secure Gateway Integration: Supports authenticated local LLM endpoints via loopback binding for secure local development.
SKILL.md
Loading
Related Openclaw Skills
Smart Context
A behavioral optimization protocol designed to make AI agents cost-aware, token-efficient, and logically concise.
Table Image Skill
A specialized utility to transform markdown tables into readable PNG images for messaging platforms with limited table support.
News Summary
An automated news aggregator that fetches international headlines and generates text or audio briefings using AI.
Apple Calendar CLI (accli)
A command-line interface for managing Apple Calendar events and availability on macOS.
Smart Context
A token-efficient behavior skill designed to minimize costs and maximize speed by optimizing agent responses and tool usage.
trein
A comprehensive CLI tool and skill for interacting with the Dutch Railways (NS) API to plan trips and monitor train status.
Featured*
