fest commit

Create git commit with task reference

Synopsis

Create a git commit with the festival/task ID embedded in the message.

Requires festival context: either run from inside a festival directory, a linked project directory (see 'fest link'), or use --festival to specify one.

The fest commit command wraps git commit and automatically:

  1. Stages changes and prepends the festival reference to the commit message
  2. Creates a campaign root commit for festival-scoped files (task docs, progress, state)

When run from a linked project directory, two commits are created:

  • Project commit: stages all project changes
  • Campaign root commit: stages only festival directory, .campaign/fest/, festivals/.festival/.state/, and the submodule pointer

When run from a festival directory, one commit is created at the campaign root with only festival-scoped files staged (not git add -A).

Use --no-root to skip the campaign root commit.

Reference format: [OBEY-FE-{id}]

  • OBEY: Obey workflow tool prefix
  • FE: Festival component identifier
  • {id}: Task ref (FEST-xxxxxx) or festival ID (e.g., CS0001)

Detection priority:

  1. Explicit --task flag value
  2. Task fest_ref from current directory (if inside festival task)
  3. Festival ID from fest.yaml metadata
  4. Explicit --festival flag (name or ID)

Examples:

  fest commit -m "Implement feature"
  # In linked project → [OBEY-FE-CS0001] Implement feature
  # In festival task  → [OBEY-FE-FEST-a3b2c1] Implement feature

  fest commit --task FEST-b4c5d6 -m "Related work"
  # → [OBEY-FE-FEST-b4c5d6] Related work

  fest commit --festival OA0001 -m "Work from unlinked dir"
  # → [OBEY-FE-OA0001] Work from unlinked dir

  fest commit --no-tag -m "No reference"
  # → No reference

  fest commit --stage=false -m "Only commit staged"
  # Skip auto-staging, commit only what's already staged

fest commit [flags]

Options

      --festival string   festival name or ID (overrides auto-detection)
  -h, --help              help for commit
      --json              output result as JSON
  -m, --message string    commit message
      --no-root           skip campaign root commit (project commit only)
      --no-tag            don't prepend task reference
      --stage             auto-stage all changes before commit (default true)
      --task string       task reference ID to use (e.g., FEST-a3b2c1)

Options inherited from parent commands

      --config string   config file (default: ~/.config/fest/config.json)
      --debug           enable debug logging
      --no-color        disable colored output
      --verbose         enable verbose output

SEE ALSO

  • fest - Festival Methodology CLI - goal-oriented project management for AI agents