Project state management commands.
Wraps claude project purge, which deletes all Claude Code state for a
project: transcripts, tasks, file history, and the project's config entry.
Destructive command
purge/2 permanently deletes project state. Pair it with dry_run: true
to preview, and yes: true to run headless -- the CLI hangs on its
confirmation prompt when stdin/stdout is not a TTY, which every wrapper
consumer is by definition.
Usage
config = ClaudeWrapper.Config.new()
# Preview what would be deleted for a specific project, no confirmation
{:ok, preview} =
ClaudeWrapper.Commands.Project.purge(config, path: "/some/project", dry_run: true)
# Purge a specific project headless
{:ok, _} = ClaudeWrapper.Commands.Project.purge(config, path: "/some/project", yes: true)
# Purge every known project headless
{:ok, _} = ClaudeWrapper.Commands.Project.purge(config, all: true, yes: true)Summary
Functions
Delete all Claude Code state for a project.
Functions
@spec purge( ClaudeWrapper.Config.t(), keyword() ) :: {:ok, String.t()} | {:error, term()}
Delete all Claude Code state for a project.
Removes transcripts, tasks, file history, and the project's config entry.
Without :path or :all, the CLI defaults to the current directory.
Options
:path- Purge state for the project at this path (positional argument). Mutually exclusive with:allat the CLI level.:all- Purge state for every known project (--all, boolean). Mutually exclusive with:pathat the CLI level.:dry_run- List what would be deleted without deleting anything (--dry-run, boolean).:interactive- Prompt for each item before deleting (--interactive, boolean). Only useful in TTY contexts; headless callers should leave this off and pair:dry_runwith:yes.:yes- Skip the confirmation prompt (--yes, boolean). Required when stdin or stdout is not a TTY, which every wrapper consumer is by definition.