cf dev

A command reserved for plugin developers.

⚠️ This command is intended for developers contributing to the Coding Friend plugin itself. If you're just using Coding Friend as an end user, you don't need this command.

Usage

cf dev on [path]    # Switch to local plugin source
                    # ⚠️ Without [path], it must be run from the root
                    # of the coding-friend repo
cf dev off          # Switch back to remote marketplace
cf dev status       # Show current dev mode
cf dev sync         # Sync local changes to cache (no version bump needed)
cf dev restart      # Full reinstall via off + on cycle (recovery)
cf dev update       # Refresh local plugin via uninstall + reinstall (fast)

Subcommands

  • cf dev on - Switch to local plugin source. This will uninstall the remote plugin and add the local directory as a marketplace. You will see more information when you run this command.
  • cf dev off - Switch back to remote marketplace. This restores the remote marketplace and reinstalls the plugin from GitHub.
  • cf dev status - Show current dev mode.
  • cf dev sync - Sync local changes to cache without bumping the version. Useful for testing changes without reinstalling the plugin. Since Claude stores plugins in versioned cache directories, this command copies your local changes to the active cache directory.
    • ⚠️ When you bump the version, you have to use cf dev update to update the cached plugin to the latest version.
  • cf dev restart - Performs a full clean reinstall of the local dev plugin (off + on). Use this when the install state is broken or corrupted and you need a clean reinstall.
  • cf dev update - Refresh the local dev plugin against the existing local marketplace (uninstall + reinstall, no remote round-trip). Use this when you have new local changes (e.g. after a version bump) and want to update the cached plugin. Falls back to a full restart cycle if you pass a different path, or if the local marketplace is no longer registered.

Notes

  • Dev state is stored at ~/.coding-friend/dev-state.json
  • Restart Claude Code (or reload VSCode window) after switching to see changes.
  • For CLI-only sessions, you can also use claude --plugin-dir /path/to/coding-friend as a lighter alternative (session-scoped, no install needed), check the official documentation for more details.