Skip to content

Command line reference

Run devpit with no arguments to open the app. The commands below are for scripts, AI agents, the installer and quick checks.

This page is generated from the app’s own command definitions, so it always matches the version you install.

A pit stop for your dev machine.

Devpit is a toolkit for developers on Windows: the right account in every folder, disk space back, stuck ports freed, tools updated and big folders moved between PCs, from one menu.

Run it with no arguments to open the app.

For scripts and AI agents: every read command takes –json and never asks anything. A command that would change something asks first at a terminal (default No); with nobody at a terminal it changes nothing and exits 3 unless –yes is given, and –yes is only for after the user agreed. Agents: run devpit agent install for a skill with these rules.

Exit codes:

  • 0: done
  • 1: failed
  • 2: wrong usage
  • 3: needs –yes: it would change something and nobody agreed
  • 4: verify found a mismatch
devpit [flags]

Flags

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier
-h, --help bool false help for devpit
-v, --version bool false version for devpit

Examples

Terminal window
devpit
devpit --ascii
devpit accounts --json
devpit claude use work --yes
devpit version --short

Subcommands

  • accounts: Show every tool’s account in this folder
  • agent: Teach AI agents to use Devpit safely
  • claude: Show the Claude Code account used here, and why
  • clean: Free up disk space without opening the app (not available yet)
  • cloudflare: Show the Cloudflare account used here, and why
  • completion: Generate the autocompletion script for the specified shell
  • convex: Show the Convex account used here, and why
  • firebase: Show the Firebase account used here, and why
  • font: Install, remove or check the icon font
  • git: Show the Git account used here, and why
  • github: Show the GitHub account used here, and why
  • ports: List or free busy dev ports (not available yet)
  • settings: Read or change a setting without opening the app (not available yet)
  • share: Share files between PCs on your network (open the app to do it)
  • supabase: Show the Supabase account used here, and why
  • undo: Undo the last account change
  • update: Update tools through every detected package manager (not available yet)
  • use: Switch every tool that has an account with this name
  • vercel: Show the Vercel account used here, and why
  • version: Print the Devpit version

Show every tool’s account in this folder.

The Accounts table for this folder (or –folder): every tool, the account it uses, why, and anything wrong with its fix. It never runs a tool’s sign-in check.

–json shape: {folder, tools: [{tool, tool_name, folder, account: {name, email, login, display}, why, reason, rule_folder, everywhere, chain: [{folder, account, won, skipped}], installed, managed, supports: {folder_rules, everywhere, just_once, add_account, show_only, beta, why}, problems: [{kind, tool, message, fix, docs}]}], warning}. docs is the troubleshooting page that explains a problem.

devpit accounts [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit accounts
devpit accounts --json
devpit accounts verify

Subcommands

  • cleanup: Remove everything Devpit added for accounts, and nothing else
  • verify: Check, for every tool, that the expected account is the one in use

Remove everything Devpit added for accounts, and nothing else.

Lists exactly what Devpit added (the folder rules, the shims and their PATH entry, its Git files, its [include] block and the github.com sign-in helper, the Wrangler bindings it made, the agent skill) and, after a yes, removes only that. Account folders and sign-ins are never deleted. –copy-links also turns a Claude Code account’s links to your default setup into its own copies, so it keeps working without them.

devpit accounts cleanup [flags]

Flags

Flag Type Default What it does
--copy-links bool false also turn shared Claude Code links into each account’s own copies
--yes bool false remove without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit accounts cleanup
devpit accounts cleanup --yes

Check, for every tool, that the expected account is the one in use.

For every installed tool, compares the account Devpit expects in this folder with what the tool says (Git and GitHub pushes offline, the others by asking the tool who is signed in), and lists every problem with its fix. Exit code 4 when anything does not match.

By default only the account used in this folder is asked. –all asks every account; a check that can sign an idle account out (Claude Code) is skipped, with the reason, unless you agree at the prompt or pass –yes after the user agreed.

–json shape: {folder, mismatch, checks: [{tool, account, here, expected, actual: {state, email, login, name, org, plan, method, note}, says, how, status, notes, docs}], problems: [{kind, tool, message, fix, docs}], skipped}. status is ok, mismatch, info, not installed or error.

devpit accounts verify [flags]

Flags

Flag Type Default What it does
--all bool false also check every account not used in this folder
--folder string none the folder to check instead of the current one
--json bool false print machine-readable output
--yes bool false with –all, also run checks that can sign an idle account out; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit accounts verify
devpit accounts verify --json
devpit accounts verify --all

Teach AI agents to use Devpit safely.

devpit agent install writes a Devpit skill (SKILL.md) into Claude Code’s skills folder and into each Claude Code account Devpit manages, and prints an AGENTS.md section for other agents. The skill tells an agent to check with read commands first, to explain with the matching page from devpit.zubyr.dev/llms.txt, to ask before any change, and never to read account folders. devpit agent status says where it is and whether it is current. devpit agent remove takes out only the files it wrote.

devpit agent

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit agent status
devpit agent install
devpit agent remove

Subcommands

  • install: Write the Devpit skill for Claude Code and print an AGENTS.md section
  • remove: Remove the Devpit skill files Devpit wrote
  • status: Show whether the Devpit skill is installed for Claude Code, and its version

Write the Devpit skill for Claude Code and print an AGENTS.md section.

Writes skills\devpit\SKILL.md into ~/.claude and into each Devpit-managed Claude Code account that does not already get it through a shared link, and updates Devpit’s own older skill. A devpit skill Devpit did not write, or one from a newer Devpit, is never overwritten. Running it again changes nothing. Without Claude Code on this PC it writes nothing.

devpit agent install [flags]

Flags

Flag Type Default What it does
--yes bool false write without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit agent install
devpit agent install --yes

Remove the Devpit skill files Devpit wrote.

Removes only SKILL.md files carrying Devpit’s marker, written in place (never through a shared link), and their devpit folder when it is then empty.

devpit agent remove [flags]

Flags

Flag Type Default What it does
--yes bool false remove without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit agent remove
devpit agent remove --yes

Show whether the Devpit skill is installed for Claude Code, and its version.

Says whether Claude Code was found (claude on PATH, a ~/.claude folder, or a Claude Code account in Devpit; claude is never run) and, for each place the skill goes, whether Devpit’s skill is there, older, newer, in the way of a devpit skill someone else wrote, or shared through a link. Changes nothing.

–json shape: {claude_code, claude_code_why, version, state, can_install, targets: [{account, file, state, version, shared_with, through_link, note}]}. state is one of: Claude Code not found, not installed, installed, installed through a shared link, update available, a different devpit skill is in the way. A target’s state is create, update, up to date, newer, not Devpit’s or shared.

devpit agent status [flags]

Flags

Flag Type Default What it does
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit agent status
devpit agent status --json

Show the Claude Code account used here, and why.

Shows which Claude Code account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Devpit can set folder rules, an account for everywhere, just this once (run) for Claude Code.

devpit claude [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit claude
devpit claude --json
devpit claude use work
devpit claude list

Subcommands

  • add: Sign in to another Claude Code account and name it
  • import: Bring claude-acc’s accounts and folder links into Devpit
  • list: List the Claude Code accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another Claude Code account and name it.

Runs Claude Code’s own sign-in for a new account, then asks for a name (suggested from the email). A sign-in that does not finish leaves nothing behind. With nobody at a terminal, –name and –yes are needed.

Devpit can set folder rules, an account for everywhere, just this once (run) for Claude Code.

devpit claude add [flags]

Flags

Flag Type Default What it does
--console bool false sign in with an Anthropic Console account (API billing)
--email string none pre-fill the sign-in page with this email, where the tool supports it
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit claude add
devpit claude add --name work --yes

Bring claude-acc’s accounts and folder links into Devpit.

Reads claude-acc’s own files (its accounts, folder links and default account), shows what Devpit would add, and after a yes adds them as one change devpit undo takes back. Accounts stay where they are, so nobody signs in again. Then it prints the steps to retire claude-acc safely.

devpit claude import --from claude-acc [flags]

Flags

Flag Type Default What it does
--from string none where to import from: claude-acc
--yes bool false import without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit claude import --from claude-acc
devpit claude import --from claude-acc --yes

List the Claude Code accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit claude list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit claude list
devpit claude list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Devpit can set folder rules, an account for everywhere, just this once (run) for Claude Code.

devpit claude run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit claude run work -- claude -p "summarise this repo"

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Devpit can set folder rules, an account for everywhere, just this once (run) for Claude Code.

devpit claude use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit claude use work
devpit claude use work --folder C:\Work --yes
devpit claude use default --everywhere

Free up disk space without opening the app.

devpit clean [path] [flags]

Flags

Flag Type Default What it does
--dry-run bool false report what would be deleted, delete nothing
--json bool false print machine-readable output
--resume bool false finish tombstones left by an interrupted run
--yes bool false skip the confirmation prompt

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit clean D:\work --dry-run
devpit clean --resume

Show the Cloudflare account used here, and why.

Shows which Cloudflare account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Devpit can set folder rules, just this once (run) for Cloudflare. Beta: it relies on a feature the tool itself calls experimental. Wrangler profiles are beta. Everywhere else, Wrangler uses its own default login (wrangler login); Devpit cannot change that in this version.

devpit cloudflare [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit cloudflare
devpit cloudflare --json
devpit cloudflare use work
devpit cloudflare list

Subcommands

  • add: Sign in to another Cloudflare account and name it
  • list: List the Cloudflare accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another Cloudflare account and name it.

Runs Cloudflare’s own sign-in for a new account, then asks for a name (suggested from the email). A sign-in that does not finish leaves nothing behind. With nobody at a terminal, –name and –yes are needed. Wrangler names the profile when it is made, so the name is asked first.

Devpit can set folder rules, just this once (run) for Cloudflare. Beta: it relies on a feature the tool itself calls experimental. Wrangler profiles are beta. Everywhere else, Wrangler uses its own default login (wrangler login); Devpit cannot change that in this version.

devpit cloudflare add [flags]

Flags

Flag Type Default What it does
--email string none pre-fill the sign-in page with this email, where the tool supports it
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit cloudflare add
devpit cloudflare add --name work --yes

List the Cloudflare accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit cloudflare list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit cloudflare list
devpit cloudflare list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Devpit can set folder rules, just this once (run) for Cloudflare. Beta: it relies on a feature the tool itself calls experimental. Wrangler profiles are beta. Everywhere else, Wrangler uses its own default login (wrangler login); Devpit cannot change that in this version.

devpit cloudflare run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit cloudflare run work -- wrangler deploy

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Devpit can set folder rules, just this once (run) for Cloudflare. Beta: it relies on a feature the tool itself calls experimental. Wrangler profiles are beta. Everywhere else, Wrangler uses its own default login (wrangler login); Devpit cannot change that in this version.

devpit cloudflare use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit cloudflare use work
devpit cloudflare use work --folder C:\Work --yes
devpit cloudflare use default --everywhere

Generate the autocompletion script for the specified shell.

devpit completion

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Subcommands

  • bash: Generate the autocompletion script for bash
  • fish: Generate the autocompletion script for fish
  • powershell: Generate the autocompletion script for powershell
  • zsh: Generate the autocompletion script for zsh

Generate the autocompletion script for bash.

devpit completion bash

Flags

Flag Type Default What it does
--no-descriptions bool false disable completion descriptions

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Generate the autocompletion script for fish.

devpit completion fish [flags]

Flags

Flag Type Default What it does
--no-descriptions bool false disable completion descriptions

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Generate the autocompletion script for powershell.

devpit completion powershell [flags]

Flags

Flag Type Default What it does
--no-descriptions bool false disable completion descriptions

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Generate the autocompletion script for zsh.

devpit completion zsh [flags]

Flags

Flag Type Default What it does
--no-descriptions bool false disable completion descriptions

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Show the Convex account used here, and why.

Shows which Convex account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Convex is show-only: Convex picks the account per project. Devpit shows it but does not switch it. use, run and add stop with that reason (exit 1).

devpit convex [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit convex
devpit convex --json
devpit convex use work
devpit convex list

Subcommands

  • add: Sign in to another Convex account and name it
  • list: List the Convex accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another Convex account and name it.

Runs Convex’s own sign-in for a new account, then asks for a name (suggested from the email). A sign-in that does not finish leaves nothing behind. With nobody at a terminal, –name and –yes are needed.

Convex is show-only: Convex picks the account per project. Devpit shows it but does not switch it. use, run and add stop with that reason (exit 1).

devpit convex add [flags]

Flags

Flag Type Default What it does
--email string none pre-fill the sign-in page with this email, where the tool supports it
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit convex add
devpit convex add --name work --yes

List the Convex accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit convex list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit convex list
devpit convex list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Convex is show-only: Convex picks the account per project. Devpit shows it but does not switch it. use, run and add stop with that reason (exit 1).

devpit convex run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit convex run work -- convex deploy

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Convex is show-only: Convex picks the account per project. Devpit shows it but does not switch it. use, run and add stop with that reason (exit 1).

devpit convex use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit convex use work
devpit convex use work --folder C:\Work --yes
devpit convex use default --everywhere

Show the Firebase account used here, and why.

Shows which Firebase account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Devpit can set folder rules, an account for everywhere, just this once (run) for Firebase.

devpit firebase [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit firebase
devpit firebase --json
devpit firebase use work
devpit firebase list

Subcommands

  • add: Sign in to another Firebase account and name it
  • list: List the Firebase accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another Firebase account and name it.

Runs Firebase’s own sign-in for a new account, then asks for a name (suggested from the email). A sign-in that does not finish leaves nothing behind. With nobody at a terminal, –name and –yes are needed.

Devpit can set folder rules, an account for everywhere, just this once (run) for Firebase.

devpit firebase add [flags]

Flags

Flag Type Default What it does
--email string none pre-fill the sign-in page with this email, where the tool supports it
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit firebase add
devpit firebase add --name work --yes

List the Firebase accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit firebase list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit firebase list
devpit firebase list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Devpit can set folder rules, an account for everywhere, just this once (run) for Firebase.

devpit firebase run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit firebase run work -- firebase deploy

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Devpit can set folder rules, an account for everywhere, just this once (run) for Firebase.

devpit firebase use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit firebase use work
devpit firebase use work --folder C:\Work --yes
devpit firebase use default --everywhere

Install, remove or check the icon font.

Installs Symbols Nerd Font Mono for the current user (no admin needed) and adds it to Windows Terminal as a fallback font, so your own font is kept. The same as Settings › Icon font.

devpit font

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit font status
devpit font install --quiet

Subcommands

  • install: Install Symbols Nerd Font Mono for the current user
  • remove: Remove the icon font and undo the terminal patch
  • status: Report whether the icon font is installed

Install Symbols Nerd Font Mono for the current user.

devpit font install [flags]

Flags

Flag Type Default What it does
-q, --quiet bool false print only the one-line result

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit font install
devpit font install --quiet

Remove the icon font and undo the terminal patch.

devpit font remove

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit font remove

Report whether the icon font is installed.

devpit font status

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit font status

Show the Git account used here, and why.

Shows which Git account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Devpit can set folder rules, an account for everywhere for Git. Git takes its commit identity from its config files, not from a sign-in, so there is no “just this once”. For one commit, run git -c user.email=you@example.com commit.

devpit git [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit git
devpit git --json
devpit git use work
devpit git list

Subcommands

  • add: Sign in to another Git account and name it
  • list: List the Git accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another Git account and name it.

Adds a Git identity (Git has no sign-in): the email, the name commits are made under, and a name for it in Devpit.

Devpit can set folder rules, an account for everywhere for Git. Git takes its commit identity from its config files, not from a sign-in, so there is no “just this once”. For one commit, run git -c user.email=you@example.com commit.

devpit git add [flags]

Flags

Flag Type Default What it does
--display-name string none the name Git commits under (default: the one in your global Git config)
--email string none the email Git commits under
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit git add
devpit git add --name work --email zubair@work.com --display-name "Zubair" --yes

List the Git accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit git list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit git list
devpit git list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Devpit can set folder rules, an account for everywhere for Git. Git takes its commit identity from its config files, not from a sign-in, so there is no “just this once”. For one commit, run git -c user.email=you@example.com commit.

devpit git run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit git run work -- git commit

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Devpit can set folder rules, an account for everywhere for Git. Git takes its commit identity from its config files, not from a sign-in, so there is no “just this once”. For one commit, run git -c user.email=you@example.com commit.

devpit git use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit git use work
devpit git use work --folder C:\Work --yes
devpit git use default --everywhere

Show the GitHub account used here, and why.

Shows which GitHub account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Devpit can set folder rules, an account for everywhere, just this once (run) for GitHub.

devpit github [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit github
devpit github --json
devpit github use work
devpit github list

Subcommands

  • add: Sign in to another GitHub account and name it
  • list: List the GitHub accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another GitHub account and name it.

Runs GitHub’s own sign-in for a new account, then asks for a name (suggested from the email). A sign-in that does not finish leaves nothing behind. With nobody at a terminal, –name and –yes are needed.

Devpit can set folder rules, an account for everywhere, just this once (run) for GitHub.

devpit github add [flags]

Flags

Flag Type Default What it does
--email string none pre-fill the sign-in page with this email, where the tool supports it
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit github add
devpit github add --name work --yes

List the GitHub accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit github list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit github list
devpit github list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Devpit can set folder rules, an account for everywhere, just this once (run) for GitHub.

devpit github run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit github run work -- gh pr list

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Devpit can set folder rules, an account for everywhere, just this once (run) for GitHub.

devpit github use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit github use work
devpit github use work --folder C:\Work --yes
devpit github use default --everywhere

List or free busy dev ports.

devpit ports

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit ports

Subcommands

  • kill: Stop whatever is listening on a port (not available yet)

Stop whatever is listening on a port.

devpit ports kill <port>

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit ports kill 3000

Read or change a setting without opening the app.

devpit settings [key] [value]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit settings
devpit settings theme

Share files between PCs on your network (open the app to do it).

devpit share

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit share cleanup

Subcommands

  • cleanup: Remove a share that an earlier Devpit left behind

Remove a share that an earlier Devpit left behind.

If Devpit or the PC stopped while a folder was shared, the share, its temporary login and the firewall or network changes may still be there. This removes them. It also stops a direct hotspot Devpit started, when it still has the name Devpit gave it, removes that hotspot’s firewall rule, and turns the hotspot’s “turn off when nothing is connected” setting back on if Devpit turned it off. Windows asks for permission once.

devpit share cleanup

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit share cleanup

Show the Supabase account used here, and why.

Shows which Supabase account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Devpit can set folder rules, an account for everywhere, just this once (run) for Supabase.

devpit supabase [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit supabase
devpit supabase --json
devpit supabase use work
devpit supabase list

Subcommands

  • add: Sign in to another Supabase account and name it
  • list: List the Supabase accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another Supabase account and name it.

Runs Supabase’s own sign-in for a new account, then asks for a name (suggested from the email). A sign-in that does not finish leaves nothing behind. With nobody at a terminal, –name and –yes are needed.

Devpit can set folder rules, an account for everywhere, just this once (run) for Supabase.

devpit supabase add [flags]

Flags

Flag Type Default What it does
--email string none pre-fill the sign-in page with this email, where the tool supports it
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit supabase add
devpit supabase add --name work --yes

List the Supabase accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit supabase list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit supabase list
devpit supabase list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Devpit can set folder rules, an account for everywhere, just this once (run) for Supabase.

devpit supabase run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit supabase run work -- supabase deploy

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Devpit can set folder rules, an account for everywhere, just this once (run) for Supabase.

devpit supabase use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit supabase use work
devpit supabase use work --folder C:\Work --yes
devpit supabase use default --everywhere

Undo the last account change.

Shows what the last account change was and what undoing it puts back, asks [y/N] (default No), then puts every file back exactly as it was. If Devpit’s files were changed by hand since, it stops and says which, and changes nothing. Account folders that hold a sign-in are never deleted.

devpit undo [flags]

Flags

Flag Type Default What it does
--yes bool false undo without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit undo
devpit undo --yes

Update tools through every detected package manager.

devpit update

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit update

Switch every tool that has an account with this name.

For every tool with an account called <name> (for example “work” in Claude Code, GitHub and Vercel), uses that account in this folder (or –folder, or –everywhere). It shows every change first and asks once [y/N]; devpit undo takes all of them back together. With nobody at a terminal it changes nothing and exits 3 unless –yes is given.

devpit use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit use work
devpit use work --folder C:\Work --yes
devpit use default --everywhere

Show the Vercel account used here, and why.

Shows which Vercel account is used in this folder (or –folder), who it is, why (a folder rule or “everywhere”), the account used everywhere else, and anything wrong with a fix. It never runs the tool’s sign-in check.

Devpit can set folder rules, an account for everywhere, just this once (run) for Vercel.

devpit vercel [flags]

Flags

Flag Type Default What it does
--folder string none the folder to look at instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit vercel
devpit vercel --json
devpit vercel use work
devpit vercel list

Subcommands

  • add: Sign in to another Vercel account and name it
  • list: List the Vercel accounts
  • run: Run one command with an account, just this once (nothing is saved)
  • use: Use an account in this folder and every folder inside it (or everywhere)

Sign in to another Vercel account and name it.

Runs Vercel’s own sign-in for a new account, then asks for a name (suggested from the email). A sign-in that does not finish leaves nothing behind. With nobody at a terminal, –name and –yes are needed.

Devpit can set folder rules, an account for everywhere, just this once (run) for Vercel.

devpit vercel add [flags]

Flags

Flag Type Default What it does
--email string none pre-fill the sign-in page with this email, where the tool supports it
--name string none the name for the new account in Devpit
--yes bool false add it without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit vercel add
devpit vercel add --name work --yes

List the Vercel accounts.

Lists “default” and every named account, who it is, where it is used, and accounts the tool itself has that Devpit does not list yet. The one used in this folder is marked.

devpit vercel list [flags]

Flags

Flag Type Default What it does
--folder string none mark the account used in this folder instead of the current one
--json bool false print machine-readable output

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit vercel list
devpit vercel list --json

Run one command with an account, just this once (nothing is saved).

Starts the command with the account applied to it and to everything it starts. Nothing is saved, so nothing needs undoing and no –yes is asked for. The exit code is the command’s own. Vercel, Firebase and Cloudflare take the account as a command-line option, so for them the command must start with the tool (or npx and the tool).

Devpit can set folder rules, an account for everywhere, just this once (run) for Vercel.

devpit vercel run <name> -- <command> [args...]

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit vercel run work -- vercel deploy

Use an account in this folder and every folder inside it (or everywhere).

Shows in plain words what would change and the exact files Devpit writes, asks [y/N] at a terminal (default No), then makes the change step by step. It can be undone with devpit undo. A unique start of a name works (“wo” for “work”); “default” is the tool’s own sign-in.

With nobody at a terminal it changes nothing and exits 3 unless –yes is given. Devpit can set folder rules, an account for everywhere, just this once (run) for Vercel.

devpit vercel use <name> [flags]

Flags

Flag Type Default What it does
--everywhere bool false use it wherever no folder rule says otherwise
--folder string none the folder (and every folder inside it) to use it in, instead of the current one
--yes bool false make the change without asking; only after the user agreed

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit vercel use work
devpit vercel use work --folder C:\Work --yes
devpit vercel use default --everywhere

Print the Devpit version.

devpit version [flags]

Flags

Flag Type Default What it does
--short bool false print only the version number

Flags from devpit

Flag Type Default What it does
--ascii bool false force the plain ASCII icon tier

Examples

Terminal window
devpit version
devpit version --short
Variable What it does
DEVPIT_NO_TELEMETRY Set to 1 to switch usage stats off, whatever the setting says.
DO_NOT_TRACK The common Do Not Track switch. Set to 1 to switch usage stats off.
DEVPIT_NO_UPDATE_CHECK Set to 1 to skip the once-a-day check for a newer Devpit.
DEVPIT_CONFIG_DIR Use this folder for config.toml instead of %APPDATA%\devpit.
DEVPIT_CACHE_DIR Use this folder for caches and logs instead of %LOCALAPPDATA%\devpit.
DEVPIT_ACCOUNTS_DIR Use this folder for the account folders Devpit creates instead of %USERPROFILE%.devpit\accounts. Devpit’s Git rule files move with it, to a git folder beside it. Meant for tests and portable installs.
DEVPIT_SHIM_DIR Use this folder for the account shims (claude.exe, gh.exe and the rest) instead of %LOCALAPPDATA%\Programs\devpit\shims. While it is set, Devpit does not change your user PATH, so put that folder first on PATH yourself. Meant for tests and portable installs.
DEVPIT_REDUCED_MOTION Turn off spinners and other movement in the app.