fossil-ci

View documentation for the original command

$ tldr fossil commit

fossil ci|commit [OPTIONS] [FILENAME ...]

--allow-empty
    Allow commit with no changes

--allow-fork
    Allow forking on trunk

--branch <NAME>
    Create new branch NAME

--date-override <DATETIME>
    Use DATETIME instead of current time

--detail
    Show full diff in verbose output

-m|--message <TEXT>
    Use TEXT as commit message

-M|--message-file <FILE>
    Read message from FILE

--no-prompt
    Skip interactive prompts

--no-verify
    Skip pre-commit verification

--private|-X
    Keep check-in private to user

--props <KV-LIST>
    Set artifact properties

--tag <TAGNAME>
    Add TAGNAME to check-in

--user-override <USER>
    Use USER as committer

-h|--help
    Show help

-v|--verbose
    Enable verbose output

The fossil ci (or fossil commit) command records changes in the local checkout to the Fossil repository, creating a new check-in artifact. It combines modified files, captures the current state, and associates it with a user-provided message, timestamp, and tags. By default, it commits all modified and new files unless specific files are listed. It prompts for a commit message if not supplied via options. Designed for Fossil's integrated DVCS, it supports branching, private check-ins, and integration of changes. Use in a checkout directory; fails outside one. Supports overrides for user, date, and properties to handle edge cases like clock skew or shared repos.

Key features include private commits (-X), branch creation (--branch), and tagging (--tag). It verifies changes before committing unless disabled, ensuring data integrity. Ideal for solo or team development with Fossil's built-in wiki, tickets, and forum.

Requires a valid Fossil checkout; fails silently if no changes. Interactive prompts may hang in non-TTY. Clock skew needs --ignore-clock-skew or override. Not atomic with external tools.

fossil ci -m "Fix bug #123"
fossil ci --branch featureX src/file.c
fossil ci --private

0: success; 1: error (no changes, unclean repo, etc.)

Introduced in Fossil 2007.1 (2007) by D. Richard Hipp as core DVCS feature. Evolved with options like --private (2008), --branch enhancements (2010+). Actively maintained; latest in Fossil 2.24 (2024).

fossil(1), git-commit(1), hg(1)