\r \r

god-mode Skill\r

\r

Developer oversight and AI agent coaching for OpenClaw.\r \r

Overview\r

\r god-mode gives you a bird's-eye view of all your coding projects and coaches you to write better AI agent instructions.\r \r Key features:\r

• Multi-project status dashboard\r
• Incremental sync from GitHub (Azure/GitLab coming)\r
• Agent instruction analysis based on commit patterns\r
• Local SQLite cache for fast queries\r \r

Quick Start\r

\r

# First-run setup\r
god setup\r
\r
# Add a project\r
god projects add github:myuser/myrepo\r
\r
# Sync data\r
god sync\r
\r
# See overview\r
god status\r
\r
# Analyze your agents.md\r
god agents analyze myrepo\r
```\r
\r
## Commands\r
\r
### `god status [project]`\r
Show overview of all projects, or details for one:\r
```bash\r
god status              # All projects\r
god status myproject    # One project in detail\r
```\r
\r
### `god sync [project] [--force]`\r
Fetch/update data from repositories:\r
```bash\r
god sync                # Incremental sync all\r
god sync myproject      # Just one project\r
god sync --force        # Full refresh (ignore cache)\r
```\r
\r
### `god projects`\r
Manage configured projects:\r
```bash\r
god projects                        # List all\r
god projects add github:user/repo   # Add project\r
god projects remove myproject       # Remove project\r
```\r
\r
### `god agents analyze \x3Cproject>`\r
Analyze agents.md against commit history:\r
```bash\r
god agents analyze myproject\r
```\r
\r
Finds gaps between your agent instructions and actual work patterns, suggests improvements.\r
\r
### `god agents generate \x3Cproject>` (Coming Soon)\r
Bootstrap agents.md for a new project by analyzing repo structure.\r
\r
## Configuration\r
\r
Config file: `~/.config/god-mode/config.yaml`\r
\r
```yaml\r
projects:\r
  - id: github:user/repo\r
    name: My Project      # Display name\r
    priority: high        # high/medium/low\r
    tags: [work, api]\r
    local: ~/code/myrepo  # Local clone path\r
\r
sync:\r
  initialDays: 90         # First sync lookback\r
  commitsCacheMinutes: 60\r
\r
analysis:\r
  agentFiles:             # Files to search for\r
    - agents.md\r
    - AGENTS.md\r
    - CLAUDE.md\r
    - .github/copilot-instructions.md\r
```\r
\r
## Data Storage\r
\r
All data stored locally in `~/.god-mode/`:\r
- `cache.db` - SQLite database (commits, PRs, issues, analyses)\r
- `contexts/` - Saved workspace contexts (v0.2)\r
\r
## Authentication\r
\r
god-mode uses your existing CLI authentication:\r
\r
| Provider | CLI | Setup |\r
|----------|-----|-------|\r
| GitHub | `gh` | `gh auth login` |\r
| Azure | `az` | `az login` |\r
| GitLab | `glab` | `glab auth login` |\r
\r
**No tokens stored by god-mode.** We delegate to CLIs you already trust.\r
\r
## Requirements\r
\r
- `gh` - GitHub CLI (for GitHub repos)\r
- `sqlite3` - Database\r
- `jq` - JSON processing\r
\r
## Examples\r
\r
### Morning Check-In\r
```bash\r
god status\r
# See all projects at a glance\r
# Notice any stale PRs or quiet projects\r
```\r
\r
### Before Switching Projects\r
```bash\r
god status myproject\r
# See recent activity, open PRs, issues\r
# Remember where you left off\r
```\r
\r
### Improving Your AI Assistant\r
```bash\r
god agents analyze myproject\r
# Get suggestions based on your actual commit patterns\r
# Apply recommendations to your agents.md\r
```\r
\r
### Weekly Review\r
```bash\r
god status\r
# Review activity across all projects\r
# Identify projects needing attention\r
```\r
\r
## Agent Workflows\r
\r
### Daily Briefing (Heartbeat)\r
```markdown\r
# HEARTBEAT.md\r
- Run `god status` and summarize:\r
  - Projects with stale PRs (>3 days)\r
  - Projects with no activity (>5 days)\r
  - Open PRs needing review\r
```\r
\r
### Agent Analysis (Cron)\r
```yaml\r
# Weekly agent instruction review\r
schedule: "0 9 * * 1"  # Monday 9am\r
task: |\r
  Run `god agents analyze` on high-priority projects.\r
  If gaps found, notify with suggestions.\r
```\r
\r
## Troubleshooting\r
\r
### "gh: command not found"\r
Install GitHub CLI: https://cli.github.com/\r
\r
### "Not logged in to GitHub"\r
Run: `gh auth login`\r
\r
### "No projects configured"\r
Add a project: `god projects add github:user/repo`\r
\r
### Stale data\r
Force refresh: `god sync --force`\r
\r
---\r
\r
*OpenClaw Community Skill*  \r
*License: MIT*  \r
*Repository: https://github.com/InfantLab/god-mode-skill*\r