devsync cd

Synopsis

devsync cd

Description

devsync cd spawns a child shell with its working directory set to ~/.config/devsync/sync/ — the sync repository. This gives you direct access to the git repository that stores your dotfile artifacts.

From inside this shell you can run any git command: git status, git log, git add, git commit, git push, git pull, and so on. When you are done, type exit or press Ctrl-D to close the child shell and return to your original session.

The child shell inherits your current environment, including $SHELL, $PATH, and any shell configuration. If your default shell is zsh, the child shell will also be zsh.

Examples

# Open the sync directory in a shell
devsync cd

# You are now inside ~/.config/devsync/sync/
git status
git add -A
git commit -m "update dotfiles"
git push origin main

# Return to your original shell
exit

Typical use cases

• Commit and push after devsync push: devsync does not create git commits automatically. Use devsync cd to commit and push once you have updated the repository with devsync push.
• Pull from remote before devsync pull: Run git pull inside the sync directory to fetch the latest commits from the remote, then exit and run devsync pull to apply them locally.
• Inspect history: Use git log or git diff to review what changed between syncs.
• Resolve conflicts: If git reports merge conflicts in the sync repository, resolve them here.

Notes

Note

The sync directory is a standard git repository. All normal git workflows apply. devsync itself does not interfere with git history — it only reads and writes file contents.

Note

If you prefer not to use devsync cd, you can cd ~/.config/devsync/sync directly. The command is a convenience shortcut.