v1.6.0

More models!

New models joined the crew: Groq's Llama3.1, Cerebras Llama3.1, DeepSeek's lineup, and Google Gemini.

Check out the configuration template and update your settings (mods --settings) if you need to use them!

Changelog

New Features

• 3dc0a94: feat: add DeepSeek models to config template (#312) (@ArthurHeymans)
• c6e7308: feat: add cerebras llama3.1 (#339) (@jay-tau)
• e144464: feat: add groq's Llama3.1 and updated Llama3 models (#338) (@jay-tau)
• e9af3b6: feat: support for Google Gemini (#314) (@cloudbridgeuy)
• 6c20fa7: feat: use go 1.21 (@caarlos0)

Bug fixes

• 89c240e: fix: Correct baseURL configuration for Anthropic API (#309) (@nanbingxyz)
• 79ee7d5: fix: broken after glamour/glow update (@caarlos0)
• 17538ff: fix: error handling (@caarlos0)
• c3d358f: fix: error handling (@caarlos0)
• 8d4f845: fix: lint issue (@caarlos0)
• f834b65: fix: lint issues (#327) (@caarlos0)
• 5fe5c3a: fix: ollama config (#318) (@cerisara)
• 96a7150: fix: output correct model if ContinueLast (#320) (@sedlund)
• 40a0456: fix: raw output being rendered twice (#346) (@caarlos0)

Documentation updates

• 7b8f975: docs: fix links (#319) (@sedlund)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.6.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.6.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.6.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.5.0

UX improvements and more models

This release improve UX around --continue and interactive mode as well as adds more models. Read on for details.

Interactive mode: now more interactive

This release improves interactive mode, making it even easier to explore full gamut of available models in realtime. To run Mods in interactive mode use the -M/--ask-model flag.

Moar models

This release adds more models to the standard configuration as well as first class support for Cohere.

Shall we continue?

The --continue flag can be used to pick up the last conversation. This release improves things so that it will automatically use the same model.

Changelog

New Features

• 249ff08: feat(groq): Add Gemma2 (#304) (@jay-tau)
• 0bf7d1c: feat: add Mistral provider to config template (#305) (@philippgille)
• cddda66: feat: add claude-3.5-sonnet to configuration templates (#297) (@gwpl)
• 14fd43c: feat: add gpt-4o-mini to default configuration (@caarlos0)
• fe8a551: feat: add support for Cohere (#294) (@maxbrunet)
• ef92366: feat: allow to customize huh theme (#278) (@caarlos0)
• 04f45ae: feat: better -M forms (#261) (@caarlos0)
• 14e1f48: feat: continue using the same model (#292) (@caarlos0)
• 6b6b82a: feat: make GPT-4o the default model (#307) (@philippgille)

Bug fixes

• 6ea3ee2: fix: add api-key and api-key-env fields to config template (#303) (@philippgille)
• ff9a598: fix: use default max input settings (@caarlos0)

Documentation updates

• 73266f8: docs: fix install instructions (#293) (@emmceemoore)
• 23957ce: docs: v1.5 tape file (@caarlos0)

Bonus

• 8aabaf8: ci: sign & notarize macos binaries (#296) (@caarlos0)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.5.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.5.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.5.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.4.1

Changelog

Bug fixes

• 8520cea: fix: add man page (#291) (@caarlos0)
• 2efc3d9: fix: do not show examples in subcommands (#289) (@caarlos0)
• 5722fe6: fix: improve completion cmd handling (#290) (@caarlos0)

Documentation updates

• 6abdbfb: docs(readme): fix typo (@meowgorithm)
• 956198c: docs: fix winget command with full package ID (#284) (@darkvertex)
• bf1dab7: docs: how to get completions (#288) (@caarlos0)

Other work

• 510bf64: README Edits (#285) (@maaslalani)
• 7af4a43: build: update gitignore (@caarlos0)
• a004009: build: update goreleaser config (@caarlos0)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.4.1/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.4.1/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.4.1/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.4.0

Anthropic, Ollama, and GPT-4o

mods v1.4 adds support for Anthropic and Ollama, adds ChatGPT's gpt-4o model to the generated configuration file, and many other improvements! 💫

Installing ’n’ Upgrading

To grab the latest Mods grab a package or binary attached to this release below, or use a package manager:

# macOS or Linux
brew install charmbracelet/tap/mods

# Windows (with Winget)
winget install mods

# Windows (with Scoop)
scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git
scoop install mods

# Arch Linux (btw)
yay -S mods

Debian/Ubuntu

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install mods

Fedora/RHEL

echo '[charm]
name=Charm
baseurl=https://repo.charm.sh/yum/
enabled=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
sudo yum install mods

You can also just install it with go:

go install github.com/charmbracelet/mods@latest

---

Changelog

New Features

• 59edaf7: feat: --list-roles (#281) (@caarlos0)
• bf71c2a: feat: --role shell completions (#282) (@caarlos0)
• 76688b2: feat: add support for OpenAI gpt-40 (#262) (@bradyjoslin)
• 0c63172: feat: allow --dirs config|cache (#280) (@caarlos0)
• c256fe5: feat: anthropic and ollama support (#256) (@caarlos0)
• 584d275: feat: update groq models (#258) (@jay-tau)
• 1de46d4: feat: update perplexity models (#260) (@bradyjoslin)

Bug fixes

• 39c30fc: fix(readme): fix inconsistent markdown headings (#268) (@in03)
• c6edf9b: fix: --delete-older-than is weird with interactive list (#277) (@caarlos0)
• a13684e: fix: --dirs help (@caarlos0)
• 6f730ff: fix: do not make api call when --list, --delete, etc (#279) (@caarlos0)
• 6582595: fix: filter out System role messages for Anthropic API requests (#273) (@cloudbridgeuy)
• e64d1d2: fix: gpt-4o max tokens (@caarlos0)
• c74e892: fix: lint issues (@caarlos0)
• 6657059: fix: update modernc (@caarlos0)

Dependency updates

• 9ac0968: feat(deps): update bubbletea, bubbles, lipgloss (#271) (@caarlos0)
• f67535f: feat(deps): update openai (#272) (@caarlos0)

Documentation updates

• a3a25fc: docs: improve documentation around roles (@caarlos0)

Other work

• 6783bf8: build: update dependabot (@caarlos0)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.4.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.4.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.4.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.3.1

Changelog

Bug fixes

• 9527de3: fix: treat config key "role" as optional (#255) (@sylv-io)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.3.1/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.3.1/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.3.1/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.3.0

Perplexity, RunPod, roles and more

Mods v1.3 introduces support for Perplexity and RunPod, improves the conversation list, allows to use remote roles, and has some performance improvements! We hope you enjoy it! 💫

Changelog

New Features

• d535b3f: feat(ui): provide suggested use for convo ID (#246) (@bashbunni)
• 51c32c5: feat: Add Perplexity API (#241) (@bradyjoslin)
• eef3c9d: feat: add hidden --memprofile (#249) (@caarlos0)
• 258577c: feat: allow to use role from URL/filepath (#245) (@caarlos0)
• 917260a: feat: render list inside a viewport (#228) (@caarlos0)
• 1335701: feat: support for RunPod (#242) (@rachfop)

Bug fixes

• 2d59b32: fix: actually hide hidden flags (@caarlos0)
• 3c0c9df: fix: do not create anim internals when --quiet (#250) (@caarlos0)
• ef910e7: fix: handle non-existent role (#244) (@caarlos0)
• 90fd02f: fix: high ram usage while loading (#252) (@caarlos0)

Documentation updates

• 8d1d41e: docs: fix scoop instructions (@caarlos0)

Getting Mods

To grab the latest Mods grab a package or binary attached to this release below, or just use a package manager:

# macOS or Linux
brew install charmbracelet/tap/mods

# Windows (with Winget)
winget install mods

# Windows (with Scoop)
scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git
scoop install mods

# Arch Linux (btw)
yay -S mods

Debian/Ubuntu

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install mods

Fedora/RHEL

echo '[charm]
name=Charm
baseurl=https://repo.charm.sh/yum/
enabled=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
sudo yum install mods

You can also just install it with go:

go install github.com/charmbracelet/mods@latest

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.3.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.3.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.3.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.2.2

Changelog

New Features

• 9ed50d9: feat: add groq to config template (#223) (@caarlos0)
• 34b834b: feat: allow to set stop (#226) (@caarlos0)
• e48f558: feat: system roles (#227) (@caarlos0)

Bug fixes

• fc5d998: fix(docs): typos (@bashbunni)
• 6258e8c: fix: --ask-model print api name too (#214) (@caarlos0)
• 11dbf2d: fix: allow to run --settings with an invalid yaml configuration (#225) (@caarlos0)
• e466173: fix: error when running format-as is empty` (#219) (@cloudbridgeuy)
• ffa5231: fix: include api name in errors (#231) (@bashbunni)
• f979f9e: fix: only set completion response format when api is openai (#213) (@caarlos0)
• ae7c540: fix: possible index out of range (@caarlos0)
• 297b0ef: fix: update log dep (@caarlos0)
• 977f568: fix: wrap stdin in codeblock (#215) (@caarlos0)

Documentation updates

• a2b7467: docs: add some user commands example to readme (#207) (@caarlos0)

Other work

• 11a9be0: Create CODEOWNERS (@maaslalani)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.2.2/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.2.2/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.2.2/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.2.1

Changelog

Bug fixes

• 8d6920f: fix: do not use a renderer if output is not a tty (#199) (@caarlos0)
• db3a762: fix: set --quiet if running from vim (#200) (@caarlos0)
• 8684176: fix: withoutrenderer when output isn't a tty, not input (@caarlos0)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.2.1/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.2.1/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.2.1/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.2.0

Mods 1.2.0 introduces many of quality-of-life improvements: a TUI to write the prompt and choose the model to use, better handling of max tokens, gtp-4-1106-preview/gpt-3.5-turbo-1106 support, JSON support (and custom formatting texts), and --delete-older-than to tidy your local history cache.

Changelog

New Features

• 589758e: feat: --ask-model/-M (#192) (@caarlos0)
• fa19697: feat: --delete-older-than (@caarlos0)
• f85e6d5: feat: add gpt-4-1106-preview and gpt-3.5-turbo-1106 (#190) (@caarlos0)
• 9ad6a50: feat: cleaner error when the user simply exits huh (#194) (@meowgorithm)
• bef5df7: feat: implement word wrapping for formatted output (#171) (@cloudbridgeuy)
• 64381a4: feat: improve flag error handling (@caarlos0)
• da19b3b: feat: improve handling of max tokens (#189) (@caarlos0)
• e085c99: feat: support json (#188) (@caarlos0)
• 110b9e0: feat: when no args given, ask to choose model too (#191) (@caarlos0)

Bug fixes

• d85f256: fix: -p and -P (@caarlos0)
• 669bb20: fix: do not append formatting prompt to db save title (@caarlos0)
• ab291d6: fix: do not show prompt when --settings (@caarlos0)
• 5b90e0b: fix: drop leading newline in config template (@meowgorithm)
• 2d94c63: fix: handle missing prompt (#187) (@caarlos0)
• 5993b71: fix: improve --help (@caarlos0)
• 281437c: fix: improve duration flag parsing (@caarlos0)
• 3d6be47: fix: isNoArgs (@caarlos0)
• f929002: fix: lint complaining about capitalized errors (@caarlos0)
• 741c73a: fix: lint issue (@caarlos0)
• 5d32b49: fix: lint issue (@caarlos0)
• 3276472: fix: typo (@caarlos0)
• 4294c4f: fix: use hidden group (@caarlos0)

Documentation updates

• a8eb96a: docs: --delete-older-than (@caarlos0)

Other work

• dd040f3: Copyedit for ask-model help + add argument doc to README (@meowgorithm)
• 69cd9d2: Minor copy edits (@meowgorithm)
• 2d255a3: Pin huh to fix keymap-modifier (@maaslalani)
• 66c3c6e: Remove focused state border and padding on huh fields (@meowgorithm)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.2.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.2.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.2.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.

v1.1.0

Changelog

New Features

• d0d321d: feat: --show-last (#150) (@sylv-io)
• 1c1ea8a: feat: add --dirs to print the dirs mods stores its data (#155) (@caarlos0)
• 9fdc073: feat: adds support to api key on settings mods.yaml (#147) (@Streppel)
• 8fbb5e0: feat: have --quiet supress all stderr messages for success (@emivespa)
• 06cebfe: feat: reduce binary size (#158) (@caarlos0)

Bug fixes

• 5037453: fix: improve --continue (#159) (@caarlos0)

Dependency updates

• 11b577b: feat(deps): bump github.com/charmbracelet/lipgloss from 0.8.0 to 0.9.1 (#146) (@dependabot[bot])
• 57dca35: feat(deps): bump github.com/sashabaranov/go-openai from 1.15.3 to 1.16.0 (@caarlos0)
• eb083de: feat(deps): bump golang.org/x/term from 0.12.0 to 0.13.0 (#142) (@dependabot[bot])
• 63d7d91: feat(deps): bump modernc.org/sqlite from 1.25.0 to 1.26.0 (#139) (@dependabot[bot])

Documentation updates

• 927dfd5: docs: update windows instructions (@caarlos0)
• ade194a: docs: windows installation option using scoop (#120) (@goostleek)
• e97bddf: docs: winget install (@caarlos0)

Other work

• 62e1548: fix typo in Editorialize example (@cvan)
• 2121516: refactor: use ordered.First (#143) (@caarlos0)

---

Verifying the artifacts

First, download the checksums.txt file, for example, with wget:

wget 'https://github.com/charmbracelet/mods/releases/download/v1.1.0/checksums.txt'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/charmbracelet/mods/releases/download/v1.1.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/mods/releases/download/v1.1.0/checksums.txt.sig' \
  ./checksums.txt

If the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:

sha256sum --ignore-missing -c checksums.txt

Done! You artifacts are now verified!

Thoughts? Questions? We love hearing from you. Feel free to reach out on Twitter, The Fediverse, or on Discord.