A simple, lightweight terminal-based IRC client built with Go and Bubble Tea.
Download and Run the IRC client:
irc-client irc.libera.chat/6697 myusername- IRC TUI with mouse and keyboard navigation
- Multi Channel Unified Chat
- Send and receive private messages
- Command history (up/down arrows)
- Auto-reconnect with TLS fallback
- Debug mode for troubleshooting (
-vflag)
| Command | Description |
|---|---|
/join <channel> |
Join a channel |
/part |
Leave current channel |
/msg <nick> <message> |
Send private message |
/list |
List all channels on server |
/quit |
Disconnect from server |
| Key | Action |
|---|---|
Tab |
Cycle focus (Input → Channels → Chat → Users) |
Esc |
Return focus to input |
↑/↓ or j/k |
Scroll chat or navigate channels/users |
PgUp/PgDn or b/f |
Scroll chat by page |
Home/End or g/G |
Jump to top/bottom of chat |
Enter |
Send message or switch to selected channel |
F1 |
Toggle help screen |
Ctrl+C |
Quit application |
- Go 1.21 or higher
- Terminal with mouse support (recommended)
go build -o irc-client .main.go- UI, event handling, and IRC event handlersirc.go- IRC protocol implementation and connection management