---
name: "cg-tag"
section: "1"
platform: "linux"
package: "cogito"
version: "0.18.2-1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/cg-tag"
---

# cg-tag(1)

mark certain commit with a tag

## NAME

cg-tag - mark certain commit with a tag

## SYNOPSIS

cg-tag \[-m MESSAGE\]... \[-e\] \[-s\] \[OTHER\_OPTIONS\] TAG\_NAME \[OBJECT\_ID\].sp

## DESCRIPTION

Creates a tag referencing the given commit (or *HEAD*). You can then use the tag anywhere you specify a commit or tree ID..sp cg-tag will try to sign the tag if you give it the -s option. You can override the default key choice by passing it the -k argument..sp Takes the tag name and optionally the associated ID as arguments. When the standard input is not a terminal, it will accept the tag description on stdin..sp

## OPTIONS

- \-e

  Open editor for the tag description message.

- \-f

  This will make cg-tag silently overwrite the tag if it already exists.

- \-m MESSAGE

  Message associated with the tag, describing it. Multiple -m parameters will cause several description paragraphs to appear.

- \-M FILE

  Include tag description message from a file (this has the same effect as if you would cat it to stdin).

- \-k KEYNAME

  Use the given key to sign the tag, instead of the default one. You can use any key identifier GPG recognizes - the argument is passed verbatim as the *--default-key* argument to GPG.

- \-s

  Sign the tag by your private key using GPG.

OBJECT\_ID

This is most usually the ID of the commit to tag. Tagging other objects than commits is possible, but rather "unusual".

- \-h, --help

  Print usage summary.

- \--long-help

  Print user manual. The same as found in [**cg-tag**(1)](/cg-tag/1.md).

## COPYRIGHT

Copyright © Petr Baudis, 2005.sp

## SEE ALSO

cg-tag is part of [**cogito**(7)](/cogito/7.md), a toolkit for managing [**git**(7)](/git/7.md) trees..sp