aaaaqwq/god-mode

god-mode Skill

Developer oversight and AI agent coaching for OpenClaw.

Overview

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

Key features:

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

Quick Start

# First-run setup
god setup

# Add a project
god projects add github:myuser/myrepo

# Sync data
god sync

# See overview
god status

# Analyze your agents.md
god agents analyze myrepo

Commands

god status [project]

Show overview of all projects, or details for one:

god status              # All projects
god status myproject    # One project in detail

god sync [project] [--force]

Fetch/update data from repositories:

god sync                # Incremental sync all
god sync myproject      # Just one project
god sync --force        # Full refresh (ignore cache)

god projects

Manage configured projects:

god projects                        # List all
god projects add github:user/repo   # Add project
god projects remove myproject       # Remove project

god agents analyze <project>

Analyze agents.md against commit history:

god agents analyze myproject

Finds gaps between your agent instructions and actual work patterns, suggests improvements.

god agents generate <project> (Coming Soon)

Bootstrap agents.md for a new project by analyzing repo structure.

Configuration

Config file: ~/.config/god-mode/config.yaml

projects:
  - id: github:user/repo
    name: My Project      # Display name
    priority: high        # high/medium/low
    tags: [work, api]
    local: ~/code/myrepo  # Local clone path

sync:
  initialDays: 90         # First sync lookback
  commitsCacheMinutes: 60

analysis:
  agentFiles:             # Files to search for
    - agents.md
    - AGENTS.md
    - CLAUDE.md
    - .github/copilot-instructions.md

Data Storage

All data stored locally in ~/.god-mode/:

• cache.db - SQLite database (commits, PRs, issues, analyses)
• contexts/ - Saved workspace contexts (v0.2)

Authentication

god-mode uses your existing CLI authentication:

| Provider | CLI | Setup | |----------|-----|-------| | GitHub | gh | gh auth login | | Azure | az | az login | | GitLab | glab | glab auth login |

No tokens stored by god-mode. We delegate to CLIs you already trust.

Requirements

• gh - GitHub CLI (for GitHub repos)
• sqlite3 - Database
• jq - JSON processing

Examples

Morning Check-In

god status
# See all projects at a glance
# Notice any stale PRs or quiet projects

Before Switching Projects

god status myproject
# See recent activity, open PRs, issues
# Remember where you left off

Improving Your AI Assistant

god agents analyze myproject
# Get suggestions based on your actual commit patterns
# Apply recommendations to your agents.md

Weekly Review

god status
# Review activity across all projects
# Identify projects needing attention

Agent Workflows

Daily Briefing (Heartbeat)

# HEARTBEAT.md
- Run `god status` and summarize:
  - Projects with stale PRs (>3 days)
  - Projects with no activity (>5 days)
  - Open PRs needing review

Agent Analysis (Cron)

# Weekly agent instruction review
schedule: "0 9 * * 1"  # Monday 9am
task: |
  Run `god agents analyze` on high-priority projects.
  If gaps found, notify with suggestions.

Troubleshooting

"gh: command not found"

Install GitHub CLI: https://cli.github.com/

"Not logged in to GitHub"

Run: gh auth login

"No projects configured"

Add a project: god projects add github:user/repo

Stale data

Force refresh: god sync --force

---

OpenClaw Community Skill
License: MIT
Repository: https://github.com/InfantLab/god-mode-skill