Mods Features

Regular usage

By default:

• all messages go to STDERR
• all prompts are saved with the first line of the prompt as the title
• glamour is used by default if STDOUT is a TTY

Basic

The most basic usage is:

mods 'first 2 primes'

Pipe from

You can also pipe to it, in which case STDIN will not be a TTY:

echo 'as json' | mods 'first 2 primes'

In this case, mods should read STDIN and append it to the prompt.

Pipe to

You may also pipe the output to another program, in which case STDOUT will not be a TTY:

echo 'as json' | mods 'first 2 primes' | jq .

In this case, the "Generating" animation will go to STDERR, but the response will be streamed to STDOUT.

Custom title

You can set a custom title:

mods --title='title' 'first 2 primes'

Continue latest

You can continue the latest conversation and save it with a new title using --continue=title:

mods 'first 2 primes'
mods --continue='primes as json' 'format as json'

Untitled continue latest

mods 'first 2 primes'
mods --continue-last 'format as json'

Continue from specific conversation, save with a new title

mods --title='naturals' 'first 5 natural numbers'
mods --continue='naturals' --title='naturals.json' 'format as json'

Conversation branching

You can use the --continue and --title to branch out conversations, for instance:

mods --title='naturals' 'first 5 natural numbers'
mods --continue='naturals' --title='naturals.json' 'format as json'
mods --continue='naturals' --title='naturals.yaml' 'format as yaml'

With this you'll end up with 3 conversations: naturals, naturals.json, and naturals.yaml.

List conversations

You can list your previous conversations with:

mods --list
# or
mods -l

Show a previous conversation

You can also show a previous conversation by ID or title, e.g.:

mods --show='naturals'
mods -s='a2e2'

For titles, the match should be exact. For IDs, only the first 4 chars are needed. If it matches multiple conversations, you can add more chars until it matches a single one again.

Delete a conversation

You can also delete conversations by title or ID, same as --show, different flag:

mods --delete='naturals' --delete='a2e2'

Keep in mind that these operations are not reversible. You can repeat the delete flag to delete multiple conversations at once.