− Users can generate a new identity using `pijul identity new [name]`. The name used for this identity is not required to bear any relationship to a nest username or SSH identity. During identity generation, users will be asked for a password; on success, the location of the generated key will be displayed to the user (it should be the same directory as your [global configuration](configuration.md)). Pijul currently allows for the generation of one identity at a time.
+ Users can generate a new identity using `pijul identity new`. The name used for this identity is not required to bear any relationship to a Nest username or SSH identity. On success, the location of the generated identity will be displayed to the user (it should be in the same directory as your [global configuration](configuration.md)).
+
+ The program will guide you through the following questions:
+ | Field | Description | Optional? | Default |
+ | ------------- | --------------------------------------------------------------------- | --------- | ------------------------------------ |
+ | Identity name | A unique name for your identity | No | `default` |
+ | Display name | How Pijul refers to you (e.g. in `pijul log`) | No | OS account name (e.g. "Ferris Crab") |
+ | Email | An email address for people to contact | Yes | No (empty) |
+ | Encryption | If Pijul should encrypt this identity with a password | Yes | No |
+ | Expiry | If this identity should expire by a certain date | Yes | No |
+ | Remote | If this identity should be linked to a remote account (e.g. the Nest) | Yes | Yes |