Personal dotfiles repository for enhancing development environments with pre-configured tools and AI agent integrations. It targets developers seeking streamlined setups for Vim/Neovim, Tmux, Bash, and custom AI workflows via Codex CLI, Claude Code, and Cursor, offering immediate productivity gains through curated configurations and intelligent command-line tools.

How It Works

This repository centralizes essential dotfiles for shell, terminal multiplexer, and text editors, alongside a suite of custom AI agent prompts and commands. The core approach integrates AI capabilities directly into development workflows, enabling features like smart Git commits, automated PR reviews, and CI failure resolution through custom scripts and prompts compatible with OpenAI Codex, Claude Code, and Cursor. Configurations leverage popular Vim plugins for enhanced navigation, editing, and Git integration.

Quick Start & Requirements

• Primary Install: Clone the repository and execute the install.sh script. git clone https://github.com/jxnl/dots.git && cd dots && chmod +x install.sh && ./install.sh
• Dependencies: bash, git, curl, vim (or neovim). Optional: trash CLI. macOS users can leverage brew bundle --file Brewfile for common tools including codex, claude-code, python, uv, and bun.
• Setup: Installation is script-driven with numerous flags for selective setup (e.g., --agents, --vim, --codex, --interactive). Vim/Neovim plugins are managed via vim-plug and installed with :PlugInstall.
• Links: jxnl/dots GitHub Repository

Highlighted Details

• AI Agent Commands: Integrates custom slash commands for Codex CLI (compatible with Claude Code, Cursor) for tasks like gh-commit (conventional commits), gh-review-pr, and gh-fix-ci.
• Vim/Neovim Enhancements: Pre-configured with key plugins like NERDTree, fzf.vim, vim-surround, vim-fugitive, and vim-airline, offering advanced navigation, editing, Git operations, and status bar information.
• Development Tools: Includes custom scripts such as make-tests for collaborative test creation and de-slop for removing AI artifacts from code.
• Customizable Installation: Offers granular control over what components are installed via command-line flags, including dotfiles, specific agents, or individual prompts.

Maintenance & Community

Information regarding maintainers, community channels (e.g., Discord/Slack), or project roadmap is not detailed in the provided README snippet.

Licensing & Compatibility

The specific open-source license for this repository is not explicitly stated in the provided README content. Users should verify licensing terms before integrating into commercial or closed-source projects.

Limitations & Caveats

The README highlights optional macOS-specific installations via Homebrew, suggesting potential platform-specific setup nuances. Some advanced AI features may depend on external API keys or specific CLI tools (e.g., Codex CLI requires ripgrep). The gitignore file is provided as a template and requires manual installation.