Personal shell configurations, utility scripts, and installation automation for macOS and Linux. Configs and scripts are symlinked, so edits take effect without reinstalling.
Setup · Installation · Updates · Tools · Codespaces
Install with make. Go is optional; when it is available, installation also builds planner, asana, and yt-playlist-creator.
cd ~/code
git clone https://github.com/surajssd/dotfiles
cd dotfiles
make install-allTo include private dotfiles, run make clone-private before installation. The optional dotfilesprivate/ directory is a separate, ignored Git clone.
Use individual targets to install only what you need. Run make help for all targets.
| Command | Installs |
|---|---|
make install-configs |
Shell and tool configs into the home directory; zsh on macOS, bash on Linux. |
make install-local-bin |
Utility scripts into ~/.local/bin/. |
make install-skills |
Agent skills into ~/.claude/skills/ and ~/.agents/skills/. |
make install-rules |
Agent rules into ~/.claude/rules/. |
make install-planner |
The Planner command into $(go env GOPATH)/bin. |
make install-asana |
The Asana command into $(go env GOPATH)/bin. |
make install-yt-playlist-creator |
The playlist command into $(go env GOPATH)/bin. |
Skills come from skills/, tools/yt-playlist-creator/skill/, and, when present, dotfilesprivate/skills/. Private skills take precedence when names match. The ~/.agents/skills/ path is shared by Codex, Gemini, opencode, and Copilot CLI.
Planner, Asana, and yt-playlist-creator are compiled Go commands. Their installers skip the build when Go is absent. Builds may download Go modules or a toolchain; a build failure stops make install-all. Rebuild them with their install targets after changing Go code.
Installation scripts live in installers/.
make updateThis pulls the public repository and the private clone when present, refreshes vendored skills and rules, then reinstalls everything. Use make pull-master to pull without reinstalling.
- Planner manages Markdown plans and implementation status.
- Asana manages tasks and private project aliases from the terminal.
- YouTube playlist creator creates private playlists from ordered video references or song queries.
Run GitHub Copilot and W&B Inference through a local Anthropic-compatible gateway.
Enable automatic dotfiles installation in your GitHub Codespaces settings and select surajssd/dotfiles. The root install.sh runs make install-all. The development container must provide make; Go commands are built only when Go is available.
To rerun setup in an existing codespace:
/workspaces/.codespaces/.persistedshare/dotfiles/install.shThe installer uses private configs and scripts only when their optional repositories are already present. It does not clone private repositories automatically.
MIT.