Home

openspec-gradle

Gradle as a dynamic context engine for AI coding agents.

Your build tool already knows more about your project than any shell script — resolved dependencies, module relationships, framework versions, source structure, symbol graphs. openspec-gradle turns that knowledge into structured context that AI agents can actually use.

Works with Claude Code, GitHub Copilot, OpenAI Codex, and OpenCode.

Latest release: v0.35.0

Install

curl -fsSL https://raw.githubusercontent.com/ClankerGuru/openspec-gradle/main/install.sh | bash

Every Gradle project on your machine gets all tasks automatically.

Plugins

Plugin	Prefix	Command	Description
srcx	srcx-	./gradlew srcx	Source discovery, intelligence, refactoring
opsx	opsx-	./gradlew opsx	Workflow engine, exec, agent sync
wrkx	wrkx-	./gradlew wrkx	Workspace management, composite builds
claude	claude-	./gradlew claude	Claude Code CLI wrapper
copilot	copilot-	./gradlew copilot	GitHub Copilot CLI wrapper
codex	codex-	./gradlew codex	OpenAI Codex CLI wrapper
opencode	opencode-	./gradlew opencode	OpenCode CLI wrapper

How It Works

Visual guides to the key lifecycle flows:

• Installation Flow — sequence diagram of curl | bash installer steps
• Sync Flow — decision tree for opsx-sync (symlink vs fallback mode)
• Apply Lifecycle — full sequence from proposal through task execution to archive
• Agent Selection — flowchart for resolving which AI agent to use
• File Flow — how skills and instructions flow from ~/.clkx/ to each agent

Reference

• Properties Reference — complete table of all properties and environment variables
• Configuration — all Gradle properties
• Architecture — module map, dependency graph
• Init Scripts — load order, per-plugin scripts
• Exec Pipeline — agent execution, retry, verification
• Workspace — multi-repo management with workspace.json
• Changelog — release history