doot

Manage dotfiles by creating and maintaining symlinks between ~/.dotfiles and target locations.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/d3fvxl/.dotfiles --skill doot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doot
Source: https://github.com/d3fvxl/.dotfiles/tree/main/config/opencode/skills/doot
Command: npx skills add https://github.com/d3fvxl/.dotfiles --skill doot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the organization and synchronization of dotfiles by creating and maintaining symlinks from ~/.dotfiles to target locations like ~/.config and home.

Core Features & Use Cases

  • Automated symlink management between ~/.dotfiles and ~/.config or ~/ paths
  • Supports workflows: add new configs with doot add, install to apply symlinks, ls to list, restore to recover, and clean to remove orphan links
  • OpenCode-style dotfiles structure and mappings are supported for centralized configuration management

Quick Start

Install dotfiles with doot install to create symlinks and begin managing files with doot add, doot ls, and doot restore as needed.

Frequently Asked Questions about doot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate dotfiles management with symlinks on Linux?

Automate dotfiles management by creating and maintaining symlinks from a centralized ~/.dotfiles directory to target locations like ~/.config and home. Running doot install applies these symlinks to set up your personalized environment.

What is the best way to sync configuration files across multiple Linux directories?

Sync configuration files across Linux directories by centralizing them in ~/.dotfiles and using symlink mappings to target paths. Commands like doot add and doot install automate the synchronization and apply changes consistently.

Can I remove orphaned symlinks when cleaning up my dotfiles?

You can remove orphaned symlinks when cleaning up your dotfiles by running doot clean. This removes broken or unused links pointing from target directories back to the centralized ~/.dotfiles structure.

How do I add new config files to an existing symlink management workflow?

Add new config files to your symlink management workflow by running doot add. This command moves the specified file into ~/.dotfiles and creates a symlink at its original target location automatically.