agreety(1) General Commands Manual agreety(1)

# [NAME](#NAME)

agreety - A text-based greeter for greetd

# [SYNOPSIS](#SYNOPSIS)

**agreety** \[options]

# [OPTIONS](#OPTIONS)

**-h, --help**

Show help message and quit.

**-c, --cmd <command>**

Specifies the command to run on successful login. agreety will ask if none is specified.

**-f, --max-failures <num>**

Specifies the maximum number of login failures to accept before terminating. Defaults to 5.

# [DESCRIPTION](#DESCRIPTION)

agreety is a very simple text-based greeter, with an appearance similar to [**agetty**(8)](/man/enterprise-packages/greetd/agetty.8) and [**login**(1)](/man/enterprise-packages/greetd/login.1). It is bundled with [**greetd**(1)](/man/enterprise-packages/greetd/greetd.1).

To use agreety, configure it as your greeter in your greetd config file.

# [AUTHORS](#AUTHORS)

Maintained by Kenny Levinsen <contact@kl.wtf>. For more information about greetd development, see https://git.sr.ht/~kennylevinsen/greetd.

# [SEE ALSO](#SEE_ALSO)

[**greetd**(1)](/man/enterprise-packages/greetd/greetd.1) [**greetd**(5)](/man/enterprise-packages/greetd/greetd.5)

2026-09-09

---

Document: agreety(1) from greetd 0.10.3-r6 (Chainguard OS)
Source: https://git.sr.ht/~kennylevinsen/greetd