Integration
Project Workflow
By Advanced project workflow plugin for OpenClaw - smart code analysis, git integration, and GitHub automation
Install
npm install
#Configuration Example
{
"plugins": {
"entries": {
"project-workflow": {
"enabled": true,
"config": {
"autoAnalyze": true,
"gitIntegration": true,
"githubIntegration": true
}
}
}
}
}README
# Project Workflow Plugin
<div align="center">
[](https://openclaw.ai)
[](https://composio.dev)
[](LICENSE)
### **Stop repeating yourself.**
Automate your AI agent for seamless GitHub workflow. Stay on top of bugs, track completed work, and let your agent handle git history, code analysis, dependency checks, and PR management — all automatically.
</div>
---
## 🙏 Built With
This plugin is powered by amazing open-source projects:
- **[OpenClaw](https://openclaw.ai)** — The AI assistant framework that makes this plugin possible
- **[Composio](https://composio.dev)** — Seamless GitHub integration and 1000+ tool connections
Special thanks to the OpenClaw and Composio communities for building incredible tools! 🚀
---
## ⚙️ Requirements
### Required
- **Git** — Must be installed and available in PATH for local git features (history, blame, commits)
- **Node.js 22+** — Required for OpenClaw
### Optional
- **[Composio](https://composio.dev)** — For GitHub integration (PRs, issues, remote repository analysis)
- Without Composio: All local features work (git history, code analysis, dependency checks)
- With Composio: Full GitHub automation (push, PR creation, issue tracking)
**Check if Git is installed:**
```bash
git --version
```
If not installed, download from [git-scm.com](https://git-scm.com/downloads)
---
## How It Works
### 🔧 Hybrid Approach: Local + Remote
This plugin uses a **hybrid approach** for maximum flexibility:
#### **Local Git (Always Available)**
- ✅ Works **without internet**
- ✅ Works **without GitHub**
- ✅ Analyzes your local repository
- ✅ Creates commits **locally** (on your computer)
**What is a "local commit"?**
> A local commit saves your changes in git on your computer, but **does NOT send them to GitHub yet**.
>
> Think of it like writing a letter and putting it in an envelope — it's ready to send, but still in your hands.
>
> You decide when to push (send) it to GitHub.
#### **GitHub Integration (Optional, via Composio)**
- 🔄 Requires [Composio](https://composio.dev) setup
- 🔄 Analyzes remote PRs, issues, commits
- 🔄 Can push commits to GitHub
- 🔄 Can create PRs automatically
**The plugin automatically detects:**
- ✅ Is git available? → Enables git features
- ✅ Is there a remote repository? → Offers to push
- ✅ Is Composio connected? → Enables GitHub features
### 📋 Typical Workflow
```
You: "Add authentication to the API"
Plugin automatically:
1. ✅ Analyzes local git history
2. ✅ Finds related files
3. ✅ Checks dependencies
4. ✅ Makes changes
5. ✅ Creates commit locally: "feat(auth): add JWT authentication"
Agent asks:
"Changes ready! Detected remote: github.com/you/project
Composio connected ✅
What do you want to do?
1. Push to main
2. Create branch feature/auth and PR
3. Keep local only"
You choose → Plugin executes
```
### 🎯 What You Get
**Without Composio (Local Only):**
- Git history analysis
- Code structure analysis
- Smart commits with detailed messages
- Dependency checking
**With Composio (Local + GitHub):**
- Everything above, PLUS:
- Push to GitHub
- Create PRs with auto-generated descriptions
- Analyze existing PRs/issues
- Link commits to issues
---
## Features
### 🔍 Smart Code Analysis
- **`project_analyze_codebase`** — Analyze project structure, dependencies, and architecture
- **`project_gather_context`** — Automatically find all related files for a task
- Keyword-based file search using Node.js fs API
- Cross-platform support (Windows, Linux, macOS)
- No external dependencies required
### 📊 Git Integration
- **`project_git_history`** — Analyze git history (like codemaps) - who changed what and when
- Git blame integration
- Commit history analysis
### 🔗 GitHub Integration (via Composio)
- **`project_github_analyze`** — Analyze PRs, issues, commits
- Automatic PR/issue linking
- Code review automation
### ⚡ Smart Hooks
- **Auto-analysis before code changes** — Automatically gathers context before `edit`/`write`
- **Smart commit suggestions** — Generates meaningful commit messages
- **Integration checks** — Warns about potential breaking changes
## Installation
```bash
# From workspace directory
cd openclaw-project-workflow
npm install
# Install in OpenClaw
openclaw plugins install ./openclaw-project-workflow
```
## Configuration
Add to `~/.openclaw/openclaw.json`:
```json
{
"plugins": {
"entries": {
"project-workflow": {
"enabled": true,
"config": {
"autoAnalyze": true,
"gitIntegration": true,
"githubIntegration": true
}
}
}
}
}
```
## Usage
### Analyze Codebase
```
project_analyze_codebase({ projectPath: "./my-project" })
```
### Check Git History
```
project_git_history({ filePath: "src/main.ts", since: "2 weeks ago" })
```
### Gather Context
```
project_gather_context({ task: "Add authentication to API" })
```
### Analyze GitHub
```
project_github_analyze({ repo: "owner/repo", type: "pr", limit: 10 })
```
## Workflow
1. **You give a task** → Plugin gathers context automatically
2. **Analysis runs** → Git history, dependencies, related files
3. **Changes made** → Integration checks run
4. **Commit suggested** → Smart commit message generated
## Development Status
✅ **Ready to Use** — All 5 core tools implemented and tested.
**Implemented:**
- ✅ Git history analysis (`project_git_history`)
- ✅ Context gathering with fallback (`project_gather_context`)
- ✅ Integration checks (`project_check_integration`)
- ✅ Codebase analysis (`project_analyze_codebase`)
- ✅ GitHub integration via Composio (`project_github_analyze`)
**Roadmap:**
- 🔄 Smart hooks (before/after tool calls)
- 🔄 Automated testing
- 🔄 Plugin marketplace publication
## License
MIT
integration
Comments
Sign in to leave a comment