dotfiles
My personal dotfiles
The dotfiles AI sub-agent is a comprehensive configuration system that provides 19 specialized skills, custom agents, and orchestrated code review workflows for Claude Code and Codex. It includes scoped plugins for Laravel, React, and marketing, three language servers (Laravel LSP, Intelephense, TypeScript), and a six-lane parallel review system covering correctness, simplification, conventions, best practices, React, and security. The entire AI setup is version-controlled and shareable, with a standalone installer that works independently of the broader shell environment.
Key Features
Use Cases
- 01Enforcing Spatie PHP, Laravel, and JavaScript coding conventions across team codebases through automated review
- 02Running comprehensive six-lane code reviews that parallelize bug detection, simplification, conventions, best practices, React analysis, and security audits
- 03Managing Laravel Inertia React applications with framework-aware code intelligence and scoped React best practices
- 04Scaffolding and maintaining Laravel packages following spatie/package-skeleton-laravel patterns
- 05Conducting whole-codebase architecture audits to analyze state and data modeling with ranked findings (P0-P3)
- 06Reviewing and merging GitHub PRs with CI gate checks, automatic fixes, and automated contributor acknowledgments
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
dotfiles — FAQ
What is the dotfiles AI sub-agent?+
It's a version-controlled collection of 19 agent skills, custom sub-agents, language servers, and orchestrated review workflows designed for Laravel and React development with Claude Code and Codex. The AI configuration lives independently of the shell environment and can be installed standalone.
How do I install the AI sub-agent configuration?+
Run the standalone installer with 'curl -fsSL https://raw.githubusercontent.com/freekmurze/dotfiles/main/bin/install-claude-code | bash'. This installs the Claude Code CLI, symlinks the configuration to ~/.claude/, and links harness-neutral skills to Codex. For the complete dotfiles including shell tools, clone the repo to ~/.dotfiles and run 'bin/install'.
Which AI clients work with this sub-agent?+
It's designed specifically for Claude Code and Codex, sharing a single source of skills and instructions between both through strategic symlinking. The configuration includes Claude Code-specific settings.json and agents optimized for the Model Context Protocol.
What are the prerequisites and do I need API keys?+
You need Claude Code CLI installed (the standalone installer handles this), and globally installed language servers: laravel/lsp via Composer, intelephense via npm, and typescript-language-server via npm. No additional API keys are required beyond your Claude Code access.
Is this AI sub-agent free to use?+
Yes, the dotfiles configuration and all 19 skills are open source and free. You'll need a Claude Code subscription to use Claude Code itself, and Codex access for the Codex integration.
How does the review workflow work?+
The review-code and review-pr skills run six lanes in parallel: correctness bugs, PHP simplification via laravel-simplifier agent, Spatie conventions, Laravel best practices, React analysis (when JS/TS changed), and security checks. Findings are deduplicated and ranked by severity, then fixes are automatically applied.
How do I install dotfiles?+
Open the source repository on GitHub and follow its README. dotfiles is a agent — MCP Agents Market links you directly to the official repo.
Is dotfiles free?+
dotfiles is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.