Keymaps

All keymaps are configurable via setup({ keys = { ... } }).
See Configuration for details and the full list of key names.

Chat Window

Key name	Default	Action
translate_zh	tt	translate message to Chinese
tool_picker	@	open tool picker
input_editor	i	open input editor
reply	<CR>	reply / jump to original
edit	e	edit own message
delete	d	delete / revoke
forward	f	forward message
forward_with_reply	F	forward with reply context
pin	p	pin / unpin message
save	s	save to Favorites
copy	yy	copy message text
refresh	G	refresh + jump to bottom
ban	B	ban message sender
open_dm	c	open DM with message sender
help	?	toggle this help
editor_submit	<CR>	submit message in editor
editor_cancel	<Esc>	cancel editing
help_close	<Esc>	close this help
help_close_q	q	close this help (alt)
goto_last	<C-o>	switch to previous chat
reaction	r	react to message
archive	a	archive/unarchive chat
mark_unread	u	mark unread / mark as read
message_link	L	copy message link
user_profile	U	view user profile
mute	m	mute / unmute chat
perms_down	j	permission editor: move down
perms_up	k	permission editor: move up
perms_toggle	<Tab>	permission editor: toggle item
perms_up_alt	<S-Tab>	permission editor: move up (alt)
perms_save	<CR>	permission editor: save
perms_discard	<Esc>	permission editor: discard

Input Editor

Key	Action
<CR>	Send message / confirm edit
Esc	Cancel reply/edit/forward mode

Commands

Command	Description
:Tg	Global toggle: opens tg window if closed, hides it if open (from any buffer). First run: server + auth, then opens last chat
:TgLogout	Log out, clear auth data, next :Tg starts fresh
:TgSend	Send a message: :TgSend <text> to current chat, or :TgSend <chatId> <text> to specific chat
:TgTool	Open tool picker (@ equivalent)
:TgPr	Propose changes from a feature branch to main — choose squash or full merge, branch auto-deletes on completion
:TgIssue	Browse your assigned issues — create, close, assign, and create branches directly from an issue

The server runs on ports 8080/8081 (configurable via setup({ http_port, ws_port }) or TG_PORT/TG_WS_PORT env vars). Opening :Tg in another Neovim instance will connect to the same server — only the instance that started it will stop it on exit.

Mouse

Scrolling near the top/bottom of the buffer automatically loads older/newer messages.

@ Tools

Available tools via the tool picker (@ or :TgTool):

Tool	Description
@archive	Archive/unarchive current chat
@blocked	List and manage blocked users
@channels	Switch to a channel (filtered)
@chats	Switch to another chat
@contacts	Browse your contacts list
@createpoll	Create a poll in current chat
@dm	Switch to a private chat (filtered)
@draft	Save draft to server / clear draft
@eventlog	View recent admin events (member changes, edits, etc.)
@folders	Switch chat folder
@groups	Switch to a group (filtered)
@groupsettings	Group / channel settings (title, description, permissions, etc.)
@invitelinks	Manage invite links
@joinrequests	View and manage pending join requests
@jump_to_date	Jump to messages on a specific date
@markunread	Mark current chat as unread / read
@members	View and manage chat members
@mentions	Search @mentions in current chat
@messagelink	Copy shareable link of message under cursor
@mute	Mute / unmute current chat
@myprofile	View and edit your profile name and bio
@newchat	Start a new private chat by @username
@openlink	Open URL or media file under cursor
@openshared	Open shared chat or user DM
@pinchat	Pin / unpin current chat
@reaction	React to message
@refresh	Refresh messages
@refreshmedia	Download and update image for message under cursor
@saved	Open Saved Messages
@search	Search message history
@send	Send a message to current chat
@showarchived	Toggle archived chats in picker
@stoppoll	Stop a poll
@toggleheader	Toggle floating title bar visibility
@translate	Translate message under cursor
@translate_zh	Translate message under cursor to Chinese
@userinfo	View profile of message sender
@vote	Vote on the poll message under cursor
@voters	List who voted on each poll option