Enum GwmError 

pub enum GwmError {
    NotInGitRepo,
    Git(Error),
    Io(Error),
    TomlParse(Error),
    TomlSer(Error),
    Regex(Error),
    ShellExpand(LookupError<VarError>),
    InvalidBranchType {
        got: String,
        allowed: String,
    },
    InvalidIssue(String),
    InvalidDescription(String),
    WorktreeNotFound(String),
    WorktreeExists(String, String),
    BranchExists {
        name: String,
        oid: String,
    },
    GuardTripped {
        name: String,
        file: String,
    },
    CommandFailed(String),
    Config(String),
    UnbornHead {
        reason: String,
    },
    GhJsonParse {
        kind: &'static str,
        source: Error,
    },
    JsonSerialize(Error),
    LinkMissing {
        kind: LinkKind,
        branch: String,
    },
    EmptyWorkspace {
        root: String,
    },
    WorkspaceRepoRequired {
        available: String,
    },
    WorkspaceRepoNotFound {
        name: String,
        available: String,
    },
    WorkspaceUnsupportedCommand,
    Other(String),
}

Variants

NotInGitRepo

Git(Error)

Io(Error)

TomlParse(Error)

TomlSer(Error)

Regex(Error)

ShellExpand(LookupError<VarError>)

InvalidBranchType

Fields

got: String

allowed: String

InvalidIssue(String)

InvalidDescription(String)

WorktreeNotFound(String)

WorktreeExists(String, String)

BranchExists

gwm create refuses to silently reuse a pre-existing local branch (issue #99). The caller must opt in explicitly (--reuse-branch / reuse_branch: true) to attach the new worktree to the existing branch tip; otherwise this surfaces so the user can delete the stale ref or rename their request rather than ending up on whatever commit the stale branch resurrected.

Fields

name: String

oid: String

GuardTripped

Fields

name: String

file: String

CommandFailed(String)

Generic command/spawn failure. The variant is shared between every subcommand that shells out (bootstrap steps, gwm tmux, gwm zellij, the git log / git status previews in the TUI sidebar, …); callers prepend their own operation name into the inner string so the rendered message stays attributable to the verb the user actually typed.

Config(String)

UnbornHead

Issue #105: HEAD is unborn (no commits yet) or detached when a command that needs the current branch shorthand is invoked. Split out of Other so callers (and the TUI status line) can distinguish “no current branch” from arbitrary string errors.

Fields

reason: String

GhJsonParse

Issue #105: failed to deserialize a gh CLI JSON payload. kind names the payload ("issue", "pr", "pr list", "labels", "milestones") so the user can grep for which gh contract changed; source carries the underlying serde_json::Error for downstream introspection.

Fields

kind: &'static str

source: Error

JsonSerialize(Error)

Issue #38: failed to serialize a --format=json / daemon JSON-RPC payload. The output DTOs in json_api are plain structs so this is effectively unreachable, but surfacing it as a typed error keeps the JSON output paths off unwrap/expect (CLAUDE.md house rule).

LinkMissing

Issue #105: gwm open / gwm link was asked for an issue or PR linked to a branch but no such link is recorded in git-config. kind names which side (issue vs PR) is missing; branch is the branch shorthand the user queried.

Fields

kind: LinkKind

branch: String

EmptyWorkspace

Issue #36: --workspace <dir> pointed at a directory that holds no git repos directly below it. Surfaced rather than opening an empty table / TUI so the user can tell a wrong path from an empty root.

Fields

root: String

WorkspaceRepoRequired

Issue #36: gwm create in workspace mode is ambiguous without an explicit target repo — list the candidates so the user can pick one.

Fields

available: String

WorkspaceRepoNotFound

Issue #36: --repo <name> named a repo that is not present directly under the workspace root.

Fields

name: String

available: String

WorkspaceUnsupportedCommand

Issue #36: --workspace is a global flag, so clap accepts it for every subcommand, but only list, create and bare gwm (the TUI) implement it. Reject it elsewhere rather than silently ignoring it and acting on the current single repo — a wrong-target footgun for destructive commands like gwm remove (Codex review #303 P2).

Other(String)

Trait Implementations

impl Debug for GwmError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for GwmError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for GwmError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for GwmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GwmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GwmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GwmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GwmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GwmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GwmError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<LookupError<VarError>> for GwmError

fn from(source: LookupError<VarError>) -> Self

Converts to this type from the input type.