Reparteerepartee

First Connection

Quick start

After installing repartee, launch it:

repartee

You'll see the main UI with a status buffer. Let's connect to an IRC network.

Add a server

Edit ~/.repartee/config.toml (created on first run) and add a server:

[servers.libera]
label = "Libera"
address = "irc.libera.chat"
port = 6697
tls = true
autoconnect = true
channels = ["#repartee"]

Or use the /server command or interactive /wizard settings panel at runtime:

/server add libera irc.libera.chat
/server connect libera
/wizard

Join channels

Once connected, join channels with:

/join #channel
/join #secret mykey

Channels listed in your config's channels array are joined automatically on connect.

Cycle a channel

To refresh your presence in a channel (part + rejoin), use:

/cycle
/cycle #channel
/cycle Refreshing...

Navigation

  • Alt + 1-9 / 0 (or Esc + 1-9 / 0) -- switch between buffers (windows 1-10)
  • Alt + A -- jump to the buffer with the highest-priority unread activity
  • Alt + Left / Right (or Ctrl+N / Ctrl+P) -- previous / next buffer
  • Alt + L (or /bare) -- toggle WeeChat-style plain-text bare display for terminal selection and URL clicking
  • /bind -- view or customize any key binding or multi-key prefix sequence
  • /wizard -- open the full interactive Settings panel (or click the top-left gear button)
  • Click on buffer list or nick list entries
  • Mouse wheel -- scroll chat history
  • Tab -- nick completion
  • Up/Down -- input history

SASL authentication

For networks that support SASL (Libera Chat, OFTC, Soju bouncers, etc.), add credentials to ~/.repartee/.env:

# ~/.repartee/.env
LIBERA_SASL_USER=mynick
LIBERA_SASL_PASS=hunter2

Then in your config:

[servers.libera]
address = "irc.libera.chat"
port = 6697
tls = true
sasl_user = "mynick"
# sasl_pass loaded from .env
# sasl_mechanism = "SCRAM-SHA-512"  # omit for strongest-first auto-selection

Supported SASL mechanisms: PLAIN, EXTERNAL, SCRAM-SHA-1/256/512, ECDSA-NIST256P-CHALLENGE, and OAUTHBEARER (explicit opt-in for OAuth-enabled bouncers). When unpinned, Repartee selects the strongest usable mechanism offered by the server.

Detaching

You can detach from repartee and leave it running in the background. IRC connections stay alive and messages continue to be logged.

/detach

Or press Ctrl+\ or Ctrl+Z. Your terminal is restored and the shell prompt returns.

Reattach from any terminal:

repartee a

See Sessions & Detach for the full guide.

Next steps