---
name: "agreety"
section: "1"
platform: "linux"
package: "greetd-agreety"
version: "0.10.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/agreety"
---

# agreety(1)

A text-based greeter for greetd

## NAME

agreety - A text-based greeter for greetd

## SYNOPSIS

**agreety** \[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

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

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

## AUTHORS

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

## SEE ALSO

[**greetd**(1)](/greetd/1.md) [**greetd**(5)](/greetd/5.md)