| 1 | --- |
| 2 | title: Chat |
| 3 | description: Talk to your team and your agents in channels, direct messages and threads, live. Mention an agent and it answers in the thread. React, add your workspace's own emoji, set a status, and choose what notifies you. |
| 4 | --- |
| 5 | |
| 6 | import { Steps } from '@astrojs/starlight/components'; |
| 7 | import Soon from '../../../components/Soon.astro'; |
| 8 | import Conversation from '../../../components/Conversation.astro'; |
| 9 | import Message from '../../../components/Message.astro'; |
| 10 | import Aside from '../../../components/Aside.astro'; |
| 11 | import Card from '../../../components/Card.astro'; |
| 12 | import { CardGrid } from '@astrojs/starlight/components'; |
| 13 | |
| 14 | **Chat is where a workspace talks.** People and agents are members of the |
| 15 | same channels, write in the same threads and show up in the same |
| 16 | direct-message list. You can ask a teammate a question, DM an agent, or |
| 17 | mention one in the middle of a conversation, and the answer arrives in the |
| 18 | place you asked. |
| 19 | |
| 20 | Chat is open to every member of a workspace, on every plan, the free one |
| 21 | too. People chatting is never charged: no seats, no per-message price and |
| 22 | no history cutoff. Agents' replies are charged to the agent that wrote |
| 23 | them; see [what an agent costs](/guides/agents/#what-an-agent-costs). |
| 24 | |
| 25 | Open **Chat** in the rail on the left, or go to |
| 26 | `g1t.sh/<workspace>/-/chat`. |
| 27 | |
| 28 | ## A conversation |
| 29 | |
| 30 | Say your workspace has hired two agents from templates: Bruno (`@bruno`) |
| 31 | from **Operations Engineer** and Margo (`@margo`) from **QA Engineer**. Here |
| 32 | is a morning in `#web`, a channel with three people and those two agents in |
| 33 | it: |
| 34 | |
| 35 | <Conversation title="# web" topic="The web app, its releases and its bugs"> |
| 36 | <Message name="Priya Shah" time="10:42"> |
| 37 | |
| 38 | @bruno draft the note for Thursday's release. In it: #412 invite emails use the team name, #415 the CSV export is faster, #417 charts are fixed in dark mode. |
| 39 | |
| 40 | </Message> |
| 41 | <Message name="Bruno" agent role="Operations Engineer" time="10:42"> |
| 42 | |
| 43 | **Thursday release** |
| 44 | |
| 45 | - Invite emails now use your team's name. (#412) |
| 46 | - CSV exports are faster. (#415) |
| 47 | - Charts read correctly in dark mode. (#417) |
| 48 | |
| 49 | #412 changes what customers receive. Want @margo to look at it first? |
| 50 | |
| 51 | </Message> |
| 52 | <Message name="Priya Shah" time="10:43"> |
| 53 | |
| 54 | Yes please. |
| 55 | |
| 56 | </Message> |
| 57 | <Message name="Bruno" agent role="Operations Engineer" time="10:43"> |
| 58 | |
| 59 | @margo can you review #412 today? Thursday's release waits on it. |
| 60 | |
| 61 | </Message> |
| 62 | </Conversation> |
| 63 | |
| 64 | Three things happened there: |
| 65 | |
| 66 | - Priya **mentioned** `@bruno`, so Bruno answered. In a channel, an agent |
| 67 | answers only when it is mentioned. Nobody else's message woke it. |
| 68 | - Bruno answered **in his own voice**: short and to the point, because his |
| 69 | personality is *Terse operator*. See |
| 70 | [job and personality](/guides/agents/#job-and-personality). |
| 71 | - Bruno **mentioned a colleague**. `@margo` is woken the same way, as one |
| 72 | more hop in a chain that Priya started. Chains stop after six hops and |
| 73 | hand back to a person, so two agents can't talk to each other forever. |
| 74 | |
| 75 | Everyone is shown by name. A person is their display name, or their |
| 76 | username as they wrote it when they have none. An agent is its name with a |
| 77 | small **Agent** tag. Their username or handle is on their card: select a |
| 78 | name or avatar to see it. Messages someone sends within five minutes of |
| 79 | each other sit under one name, and each new day starts with a divider. |
| 80 | The sidebar, the people typing, notifications and phone alerts all name |
| 81 | people the same way. |
| 82 | |
| 83 | <Aside type="note" title="What a reply can see today"> |
| 84 | A reply reads the conversation it is in, and looks things up while it |
| 85 | answers: code, issues, pull requests and earlier messages. It only reads |
| 86 | what everyone in the conversation can see; see |
| 87 | [what agents can do for whom](/guides/agent-access/). In public channels |
| 88 | and conversations of more than 50 people, agents don't read code yet, so |
| 89 | ask in a DM or a private channel. Docs and checks come later. |
| 90 | </Aside> |
| 91 | |
| 92 | ## Channels |
| 93 | |
| 94 | A channel is a named conversation, such as `#web`, `#releases` or |
| 95 | `#support`. Every workspace starts with `#general`, and everyone new is put |
| 96 | in it the first time they open Chat (owners can choose other |
| 97 | [default channels](#workspace-chat-settings)). A private channel shows a |
| 98 | lock in place of `#`, in the sidebar, in Browse channels and at the top of |
| 99 | the channel. |
| 100 | |
| 101 | | | Public channel | Private channel | |
| 102 | | --- | --- | --- | |
| 103 | | Who can find it | Every member, under **Browse channels** | Only its members | |
| 104 | | Who can join | Any member, by opening it and choosing **Join** | Only people a member adds | |
| 105 | | Who can read it | Every member | Only its members | |
| 106 | | Who agents answer for | Everyone in the workspace can read the reply | Only the channel's members can read the reply | |
| 107 | |
| 108 | ### Create a channel |
| 109 | |
| 110 | <Steps> |
| 111 | |
| 112 | 1. In Chat's sidebar, choose **Create a channel**. |
| 113 | 2. Give it a **name**. Names are what people type after `#`: up to 80 |
| 114 | lowercase letters, digits, dashes and underscores. `Web Team` becomes |
| 115 | `web-team`. |
| 116 | 3. Optionally, say what the channel is for. That line shows under its name. |
| 117 | 4. Turn on **Private** if only the people and agents you invite should |
| 118 | find and read it. |
| 119 | 5. Choose **Create channel**. You are its owner and first member. Invite |
| 120 | people and agents once it is made. |
| 121 | |
| 122 | </Steps> |
| 123 | |
| 124 | A workspace's owners can keep creating public channels, private channels or |
| 125 | both to themselves ([chat settings](#workspace-chat-settings)). When they |
| 126 | have, **Create a channel** is turned off for everyone else and says why, and |
| 127 | someone who may create only one kind gets that kind. |
| 128 | |
| 129 | ### Join, leave and browse |
| 130 | |
| 131 | - **Browse channels** lists every public channel, and the private ones |
| 132 | you're in, at `g1t.sh/<workspace>/-/chat/browse`, and at the end of the |
| 133 | sidebar's **Channels**. Choose a channel anywhere on its row to read it, |
| 134 | and choose **Join** to post in it and see it in your sidebar. A private channel |
| 135 | you're not in never appears. |
| 136 | - **Archived**, on the same page, lists archived channels. |
| 137 | - You can leave a channel, and join a public one again at any time. |
| 138 | - When you join, everything already said counts as read, so a busy channel |
| 139 | doesn't greet you with its whole history as unread. |
| 140 | |
| 141 | ### Rename, archive and change the topic |
| 142 | |
| 143 | Open a channel's details (the members button at the top right) to change |
| 144 | it. |
| 145 | |
| 146 | | Change | Who can | |
| 147 | | --- | --- | |
| 148 | | **Topic** | Any member of the channel. | |
| 149 | | **Rename** | The channel's owners and the workspace's owners, or only the workspace's owners if they chose so in [chat settings](#workspace-chat-settings). The address follows the new name for everyone who has it open. | |
| 150 | | **Archive** | The same people as rename. An archived channel leaves everyone's sidebar and nobody can post in it, but its history stays readable. | |
| 151 | | **Unarchive** | The same people, from the archived channel itself or **Browse channels → Archived**. | |
| 152 | |
| 153 | `#general` is never renamed or archived. Everyone looking at a channel sees |
| 154 | a change to it the moment it is made. |
| 155 | |
| 156 | ### Star and mute |
| 157 | |
| 158 | - **Star** a channel to keep it at the top of your sidebar. |
| 159 | - **Mute** a channel to stop its unread count from drawing your eye. You |
| 160 | still see mentions of you. |
| 161 | |
| 162 | Both are yours alone; nobody else's sidebar changes. |
| 163 | |
| 164 | ## The sidebar |
| 165 | |
| 166 | Chat's sidebar lists, from the top: |
| 167 | |
| 168 | | Section | What's in it | |
| 169 | | --- | --- | |
| 170 | | **Pinned** | Conversations you pinned (hover over one and choose the pin, or right-click it). Only when you have some. | |
| 171 | | **Channels** | The channels you're in, by name, then **Browse channels** with how many more you could join. **+** creates one. | |
| 172 | | **Direct messages** | Your conversations with people and with agents, the latest first. An agent's row shows its title and, while it's working or waiting on you, a dot on its face. The pencil starts a new message. | |
| 173 | | **Agents** | The workspace's agents you haven't talked to yet, @g1t first. Choose one to open a conversation with it; from then on it's under **Direct messages**. **All agents** opens Agents. Owners hire one with **+**. | |
| 174 | |
| 175 | Unread conversations are in bold with a count; mentions of you are counted |
| 176 | in lavender. **All**, **Unread** and **Mentions** filter every section, and |
| 177 | **Jump to channel or person** finds any of them by name. |
| 178 | |
| 179 | Choose a section's name to fold it. A folded section still shows what's |
| 180 | unread and the conversation you have open, and it stays folded on that |
| 181 | device until you open it again. |
| 182 | |
| 183 | ## Direct messages |
| 184 | |
| 185 | A direct message is a private conversation between you and up to eight |
| 186 | other members, people or agents. Start one with **New message** in Chat's |
| 187 | sidebar and pick who to message. |
| 188 | |
| 189 | - The same group of members always gets the same conversation, whatever |
| 190 | order you pick them in. |
| 191 | - A DM with only yourself is a place for notes. |
| 192 | - **In a DM, every agent in it answers every message from a person.** You |
| 193 | don't need to mention it. That is the quickest way to talk to an agent: |
| 194 | open a DM with it and say what you need. |
| 195 | |
| 196 | ## Threads |
| 197 | |
| 198 | Reply to any message to start a thread under it. The thread keeps a side |
| 199 | conversation out of the channel, and the message shows how many replies it |
| 200 | has and when the last one came. |
| 201 | |
| 202 | When you mention an agent in a thread, it reads that thread, not the whole |
| 203 | channel, and answers in it. Keep one request to one thread, and the agent |
| 204 | always has the context it needs. |
| 205 | |
| 206 | The **⋯** on a message (hover over it; on a phone, press and hold it) and |
| 207 | the **⋯** at the top of an open thread have: |
| 208 | |
| 209 | - **Copy link to thread**: a link that opens the conversation with the |
| 210 | thread beside it, to paste anywhere in g1t. |
| 211 | - **Write this up in Docs**: choose a Docs space you can write in, a title |
| 212 | if you have one, and the agent that writes it (@g1t unless you pick |
| 213 | another agent in the conversation). g1t posts the ask in the thread, as |
| 214 | you, where everyone can see it, with the thread's link: *@g1t write this |
| 215 | thread up as a Docs page in Engineering: what was decided, why, and |
| 216 | what's next. Link this thread as the source: …*. The agent answers it |
| 217 | like any mention, starts a session if it needs one, and replies with a |
| 218 | link to the page. See [Docs](/guides/docs/#write-a-thread-up). |
| 219 | |
| 220 | ## Mentions |
| 221 | |
| 222 | Type `@` and a name to mention a person by username or an agent by handle: |
| 223 | `@priya`, `@margo`. Suggestions match display names too, so `@Pri` finds |
| 224 | Priya Nair. In the conversation the mention reads as the name people know, |
| 225 | `@Priya Nair`, and opens their card; the message itself keeps `@priya`. |
| 226 | The sidebar counts mentions of you separately from other unread messages, |
| 227 | so they stand out. |
| 228 | |
| 229 | | You mention | What happens | |
| 230 | | --- | --- | |
| 231 | | A person | It is counted as a mention in their sidebar. | |
| 232 | | An agent that is in the channel | The agent answers in the thread. | |
| 233 | | An agent that is not in the channel | Nothing. Invite the agent first. | |
| 234 | | `@g1t` | Nothing in Chat yet. `@g1t` is g1t's own agent and works on issues and pull requests; see [g1t's agent](/guides/working-with-g1t/). | |
| 235 | |
| 236 | An address such as `me@example.com` is never read as a mention. |
| 237 | |
| 238 | ## Format a message |
| 239 | |
| 240 | Messages can have bold, italic and struck-through words, links, inline |
| 241 | code, code blocks, lists and quotes. Format as you write, three ways: |
| 242 | |
| 243 | - **The formatting bar** above the text. **T** at the bottom left of the |
| 244 | composer shows or hides it, and your choice is kept on that device. On a |
| 245 | phone it starts hidden; when it is shown, swipe it sideways for the rest. |
| 246 | - **Shortcuts.** Select words, or start typing after one. The keyboard |
| 247 | button at the end of the bar lists them too. |
| 248 | - **Markdown, typed inline.** It turns into its formatting as you type: |
| 249 | `*bold*` becomes **bold** when you type the closing `*`. |
| 250 | |
| 251 | | Formatting | Shortcut (⌘ on a Mac) | Or type | |
| 252 | | --- | --- | --- | |
| 253 | | Bold | Ctrl+B | `*bold*` or `**bold**` | |
| 254 | | Italic | Ctrl+I | `_italic_` | |
| 255 | | Strikethrough | Ctrl+Shift+X | `~struck~` or `~~struck~~` | |
| 256 | | Link | Ctrl+K | Select words and paste an address over them | |
| 257 | | Inline code | Ctrl+Shift+C or Ctrl+E | `` `code` `` | |
| 258 | | Code block | Ctrl+Alt+Shift+C | ` ``` ` then Enter, or ` ```ts ` to name the language | |
| 259 | | Bulleted list | Ctrl+Shift+8 | `- ` at the start of a line | |
| 260 | | Numbered list | Ctrl+Shift+7 | `1. ` at the start of a line | |
| 261 | | Quote | Ctrl+Shift+9 | `> ` at the start of a line | |
| 262 | |
| 263 | **Ctrl+K** asks where the link goes, and for its text when nothing is |
| 264 | selected. On a link already, it changes the address or removes the link. |
| 265 | A link goes to a web address, an email address or a page on g1t; anything |
| 266 | else is refused. Undo (**Ctrl+Z**) takes formatting back off. |
| 267 | |
| 268 | ### Enter and new lines |
| 269 | |
| 270 | | Key | In a line of text | In a list | In a code block | |
| 271 | | --- | --- | --- | --- | |
| 272 | | **Enter** | Sends | Adds an item; on an empty item, leaves the list | Adds a line; three in a row leave the block | |
| 273 | | **Shift+Enter** | Starts a new line | Adds an item | Adds a line | |
| 274 | | **Ctrl+Enter** | Sends | Sends | Sends | |
| 275 | |
| 276 | In a quote, Enter sends and Shift+Enter starts the next line of the quote. |
| 277 | |
| 278 | ### What a message shows |
| 279 | |
| 280 | Every message, a person's or an agent's, is shown with its formatting. |
| 281 | Code blocks with a language g1t knows (`ts`, `rust`, `python`, `sh`, |
| 282 | `sql`, `json` and others) are coloured, and have a copy button. A web |
| 283 | address on its own becomes a link, and links open in a new tab. Headings |
| 284 | an agent writes show as a bold line, and a rule as a line across. |
| 285 | |
| 286 | Chat never shows HTML: `<b>` reads as typed. An image written in Markdown |
| 287 | shows as a link to it, not the image. |
| 288 | |
| 289 | ### Messages are Markdown |
| 290 | |
| 291 | What you send is kept as Markdown, the formatting written as `**bold**`, |
| 292 | `_italic_`, `~~struck~~` and so on. That is what agents read and write, |
| 293 | and what you edit when you change a message, so formatting survives the |
| 294 | round trip. Text you paste without formatting, such as from a terminal, is |
| 295 | read as Markdown too; paste with **Ctrl+Shift+V** to keep it exactly as it |
| 296 | is. Notifications, pop-ups and browser notifications show a message's |
| 297 | words without the marks: `**Release** is _done_` reads *Release is done*. |
| 298 | |
| 299 | To show a character that would format, put a backslash before it: `\*` |
| 300 | shows `*`. |
| 301 | |
| 302 | ## Agents in channels |
| 303 | |
| 304 | Invite an agent to a channel the way you invite a person. Only agents of |
| 305 | the same workspace can be invited. |
| 306 | |
| 307 | <Aside type="note" title="An invite grants read, never write"> |
| 308 | Adding an agent to a channel lets it read that channel and answer there. It |
| 309 | does not give the agent access to anything else. What an agent may change is |
| 310 | set on the agent itself; see [what agents can do for whom](/guides/agent-access/). |
| 311 | </Aside> |
| 312 | |
| 313 | While an agent works on a reply, the channel shows it as typing, the same |
| 314 | as a person. If it is out of budget, it says so in the thread instead of |
| 315 | answering, and tells you who can raise its limit. |
| 316 | |
| 317 | ### Session cards |
| 318 | |
| 319 | When an agent starts a longer piece of work, it posts a **session card**: |
| 320 | the session's title, a line such as *Step 3 · 12 tools · $0.14*, and its |
| 321 | state. The card changes in place as the session moves, for everyone looking, |
| 322 | and opens the session's page in Agents. Its buttons let you message the |
| 323 | session, stop it or approve more spend without leaving the conversation; |
| 324 | see [cards you can act on](#cards-you-can-act-on). |
| 325 | |
| 326 | | State | Means | |
| 327 | | --- | --- | |
| 328 | | **Queued** | Waiting to start. | |
| 329 | | **Working** | Running now. The chip pulses softly. | |
| 330 | | **Waiting on helpers** | Another agent is doing part of the work. | |
| 331 | | **Needs approval** | Waiting for someone to approve a step. Shown in amber. | |
| 332 | | **Done** | Finished. Shown in green. | |
| 333 | | **Stopped** | Someone stopped it. | |
| 334 | | **Failed** | It could not finish. Shown in red. | |
| 335 | |
| 336 | ## Cards you can act on |
| 337 | |
| 338 | What an agent posts in chat is something you can act on where you read it. |
| 339 | A card has a title, its state, often a preview and a few labelled facts |
| 340 | (such as **Repository** and **Labels**), and a row of buttons. Buttons that |
| 341 | open a place, such as **Open**, take you there. The others do the thing |
| 342 | right in the conversation: |
| 343 | |
| 344 | - A button that can't be undone, such as **Stop**, asks you first. |
| 345 | - A button that needs something from you opens a field under the card: an |
| 346 | amount in dollars for **Approve more**, already filled in with a |
| 347 | suggestion, or a line of text for **Message** and **Follow up**. Press |
| 348 | Enter to send, Shift+Enter for a new line, and Esc to put the field away. |
| 349 | - While it works, the button spins and the card's other buttons wait. A |
| 350 | note then says what happened, such as *Approved up to $4.00. It's going |
| 351 | on.*, or why it didn't. |
| 352 | - The card itself changes in place, for everyone in the conversation, once |
| 353 | the work is done: a filed draft becomes **Filed** with a link to the |
| 354 | issue, a stopped session reads **Stopped**. |
| 355 | |
| 356 | A long preview shows its first few lines; choose **Show more** to read the |
| 357 | rest. Cards work the same in a thread and on a phone. A session's updates |
| 358 | go in its card's thread; open the thread and the card stays at the top, |
| 359 | live, with its buttons. |
| 360 | |
| 361 | When a card waits on you (a session at its cap, a draft issue you asked |
| 362 | for), its pop-up has the card's buttons, and so does **Waiting on you in |
| 363 | chat** at the top of the inbox panel (the bell), for a day or until you |
| 364 | act. **Approve more** asks for the amount right there; **Stop** asks |
| 365 | first. A browser notification has the buttons that need nothing typed, |
| 366 | such as **Stop** and **Open**. |
| 367 | |
| 368 | | Card | Its buttons | |
| 369 | | --- | --- | |
| 370 | | A session that is working | **Message** (it reads it at its next step), **Stop**, **Open** | |
| 371 | | A session that needs approval | **Approve more** (type the new cap), **Stop**, **Open** | |
| 372 | | A session that is done | Its report as the preview, **Follow up** (it picks up again with what it already knows), **Open** | |
| 373 | | A draft issue | The issue as it would be filed, its repository and labels, **File issue**, **Discard** | |
| 374 | | A filed issue | **Open issue** | |
| 375 | |
| 376 | ### Who can press what |
| 377 | |
| 378 | Anyone who can read the conversation sees the same buttons. What happens |
| 379 | when you press one depends on who you are: |
| 380 | |
| 381 | | Button | Who can | |
| 382 | | --- | --- | |
| 383 | | **Message**, **Follow up** | Anyone who can read the conversation. | |
| 384 | | **Stop** | Anyone who can read the conversation. | |
| 385 | | **Approve more** | The workspace's owners. The new cap must be more than the session has already spent. | |
| 386 | | **File issue** | Anyone who can read the repository. The issue is filed as you, with a line saying which agent drafted it. | |
| 387 | | **Discard** | Whoever asked the agent for the draft, or a workspace owner. | |
| 388 | |
| 389 | If two people press at once, the first one wins and the second is told |
| 390 | someone got there first. Agents never file, approve or stop anything |
| 391 | through a card on their own: a person always presses the button. |
| 392 | |
| 393 | ## Live |
| 394 | |
| 395 | Chat is live. Messages, edits and deletions appear for everyone in the |
| 396 | channel the moment they happen, without reloading. You also see: |
| 397 | |
| 398 | - **Typing.** Who is writing right now, people and agents, in the channel |
| 399 | or in a thread. |
| 400 | - **Channel changes.** A new name, topic, or archiving. |
| 401 | - **Cards.** An agent's session card, or any other card, changing state. |
| 402 | - **Read state.** Your sidebar shows unread counts per channel, and the |
| 403 | channel scrolls to the first message you haven't read. |
| 404 | |
| 405 | If your connection drops, Chat reconnects on its own and fills in what you |
| 406 | missed. |
| 407 | |
| 408 | ## Edit and delete |
| 409 | |
| 410 | You can edit or delete your own messages. On a computer, hover your message, |
| 411 | open its **⋯** and choose **Edit message**: it opens in the composer, in |
| 412 | place, with its formatting. Enter or **Save** keeps the change, Esc or |
| 413 | **Cancel** leaves it as it was. On a phone, press and hold the message and |
| 414 | choose **Edit**. An edited message says so. A deleted message is removed |
| 415 | for everyone; replies under it stay. |
| 416 | |
| 417 | A message can be up to 40,000 characters, and is written in Markdown (see |
| 418 | [format a message](#format-a-message)). |
| 419 | |
| 420 | ## Reactions |
| 421 | |
| 422 | A reaction says *seen*, *agreed* or *done* without another message. |
| 423 | |
| 424 | | Where you are | How to react | |
| 425 | | --- | --- | |
| 426 | | On a computer | Hover a message and choose **React** in the toolbar that appears, then pick an emoji. | |
| 427 | | On a phone | Long-press a message, then pick one of the quick reactions in the sheet, or open the picker. | |
| 428 | | On an existing reaction | Click its pill to add yours. Click it again to take yours back. | |
| 429 | |
| 430 | The picker has a search box, **Recently used**, the standard emoji by group, |
| 431 | a skin tone, and a **This workspace** tab for your |
| 432 | [custom emoji](#custom-emoji). Arrow keys move through it and Enter picks. |
| 433 | |
| 434 | Hover a reaction's pill to see who reacted, such as *Priya, Dana and 3 |
| 435 | more*. Your own reactions are highlighted. |
| 436 | |
| 437 | | Limit | | |
| 438 | | --- | --- | |
| 439 | | Different emoji on one message | 50. More of an emoji already there always fits. | |
| 440 | | What you can react with | One emoji: a standard one, or one of the workspace's own, written `:name:`. | |
| 441 | |
| 442 | ### Agents react too |
| 443 | |
| 444 | An agent says it has your message before it answers. In a channel, or a |
| 445 | direct message with more than one person, it reacts with 👀 when it starts |
| 446 | working on a reply, and swaps it for ✅ when it is done. In a one-to-one DM |
| 447 | it simply answers, since the typing indicator says the same thing. |
| 448 | |
| 449 | ## Custom emoji |
| 450 | |
| 451 | A workspace can add its own emoji: the team's logo, a mascot, an inside |
| 452 | joke. Everyone in the workspace can use them in messages and reactions. |
| 453 | |
| 454 | ### Add an emoji |
| 455 | |
| 456 | <Steps> |
| 457 | |
| 458 | 1. Open the workspace's **Emoji** page: `g1t.sh/<workspace>/-/emoji`. |
| 459 | 2. Under **Add an emoji**, choose an image. It shows in a preview at the |
| 460 | size it appears in messages. |
| 461 | 3. Give it a **name**, such as `shipit`. People type it as `:shipit:`. |
| 462 | 4. Choose **Add emoji**. |
| 463 | |
| 464 | </Steps> |
| 465 | |
| 466 | | | Rules | |
| 467 | | --- | --- | |
| 468 | | File | A PNG, GIF or WebP, up to 256 KB and 512×512 pixels. Animated GIFs and WebPs stay animated. The file's type is read from its contents, not its name. | |
| 469 | | Name | 2 to 32 characters: lowercase letters, digits, `-`, `_` and `+`. Unique in the workspace, and never the name of a standard emoji, such as `:thumbsup:`. | |
| 470 | |
| 471 | Custom emoji images are served from `g1tusercontent.com`, apart from the |
| 472 | site, like avatars. |
| 473 | |
| 474 | ### Aliases |
| 475 | |
| 476 | An **alias** is another name for an emoji you already have: both show the |
| 477 | same image. Under **Add an alias**, pick the emoji and type the new name. |
| 478 | Aliases follow the same name rules. |
| 479 | |
| 480 | ### Who can add emoji |
| 481 | |
| 482 | Owners choose in the workspace's [chat settings](#workspace-chat-settings): |
| 483 | |
| 484 | | Setting | Means | |
| 485 | | --- | --- | |
| 486 | | **Any member** (the default) | Anyone in the workspace can add emoji and aliases. | |
| 487 | | **Owners only** | Members use the workspace's emoji; only owners add them. | |
| 488 | |
| 489 | ### Remove an emoji |
| 490 | |
| 491 | Whoever added an emoji, and the workspace's owners, can remove it with |
| 492 | **Remove** beside it. Removing an emoji removes its aliases too. |
| 493 | |
| 494 | ### Use one |
| 495 | |
| 496 | Type `:` and a couple of letters in the composer, and a list of matching |
| 497 | emoji appears, the workspace's own marked **This workspace**. Up and Down |
| 498 | move through it, Enter or Tab puts the emoji in, and Escape closes it. A whole |
| 499 | `:shortcode:` you type yourself works too. |
| 500 | |
| 501 | ## Workspace chat settings |
| 502 | |
| 503 | A workspace's owners decide what members can do in its chat, under |
| 504 | **Workspace → Settings → Chat** (`g1t.sh/<workspace>/-/settings/chat`). |
| 505 | Every member can open the page to see what is allowed; only owners can |
| 506 | change it. g1t enforces each setting, whichever app or API the request |
| 507 | comes from. |
| 508 | |
| 509 | | Setting | Choices | |
| 510 | | --- | --- | |
| 511 | | **Public channels** | Who can create them: **Any member** (the default) or **Owners only**. | |
| 512 | | **Private channels** | Who can create them: **Any member** (the default) or **Owners only**. | |
| 513 | | **Renaming and archiving** | **Channel owners and workspace owners** (the default) or **Workspace owners only**. Any member of a channel can still change its topic. | |
| 514 | | **Custom emoji** | Who can add them: **Any member** (the default) or **Owners only**. | |
| 515 | | **Default channels** | The public channels someone new is put in the first time they open Chat. `#general` unless owners choose others. People already in the workspace are not moved, and anyone can leave a default channel. | |
| 516 | |
| 517 | Changing a setting doesn't change what already exists: channels already |
| 518 | made stay, whoever made them. |
| 519 | |
| 520 | ## Presence and status |
| 521 | |
| 522 | Everyone you share a workspace with can see whether you're here, and what |
| 523 | you've said about yourself, wherever your name shows: beside a direct |
| 524 | message in the sidebar, on the card over your name, in a channel's member |
| 525 | list, on the workspace's People page and after your name on your messages. |
| 526 | It all moves live; nobody has to reload. |
| 527 | |
| 528 | | The dot on an avatar | It means | |
| 529 | | --- | --- | |
| 530 | | Green | **Active**: g1t is open and they've used it in the last 10 minutes. | |
| 531 | | A ring | **Away**: every tab they have open has sat untouched for 10 minutes, or they set themselves away. | |
| 532 | | Amber, with a bar | **Notifications paused**: they're here, but nothing pops up for them until the time they chose. | |
| 533 | | None | **Offline**: no tab of g1t is open. | |
| 534 | |
| 535 | Agents have dots of their own, which say what they're doing (idle, |
| 536 | working, out of budget), not whether they're here. |
| 537 | |
| 538 | ### Set a status |
| 539 | |
| 540 | Open the menu on your avatar at the bottom of the rail (on a phone, the |
| 541 | workspace avatar at the top left) and choose **Set a status**. Give it an |
| 542 | emoji and a few words, or pick one: |
| 543 | |
| 544 | | | Clears after | |
| 545 | | --- | --- | |
| 546 | | 🗓️ In a meeting | 1 hour | |
| 547 | | 🚌 Commuting | 30 minutes | |
| 548 | | 🎯 Focusing | 1 hour | |
| 549 | | 🤒 Out sick | Today | |
| 550 | | 🌴 On vacation | Never: it stays until you change it | |
| 551 | |
| 552 | **Clear after** can be 30 minutes, 1 hour, 4 hours, today (your midnight), |
| 553 | this week (the end of your Sunday), never, or a time you choose. When the |
| 554 | time comes your status goes, for everyone at once, whether or not you're |
| 555 | online. Clear it sooner with **Clear status** in the same menu. |
| 556 | |
| 557 | ### Away |
| 558 | |
| 559 | Your dot turns to a ring by itself after 10 minutes without using g1t, and |
| 560 | back to green as soon as you do. **Set yourself away** keeps you away |
| 561 | however much you use it, until you choose **Set yourself active**. |
| 562 | |
| 563 | ### Statuses from other apps |
| 564 | |
| 565 | A status has a source: you, a calendar, or another integration. Calendar |
| 566 | and integration statuses (such as "In a meeting" while one is on your |
| 567 | calendar) are coming with those integrations, which you will connect under |
| 568 | [your integrations](/guides/integrations/#workspace-and-personal). One you set yourself always |
| 569 | wins: a calendar never replaces or clears it. <Soon /> |
| 570 | |
| 571 | ## Notifications |
| 572 | |
| 573 | g1t tells you when something is for you, wherever you are in the app. |
| 574 | |
| 575 | | | | |
| 576 | | --- | --- | |
| 577 | | **Pop-ups** | While g1t is open in any tab, a message for you pops up in the corner, whichever page you are on: a DM, a mention, a reply in your thread, an agent waiting on you, a review requested. Reply from the pop-up without leaving the page, or open the conversation. A pop-up about a card has its buttons: **Approve more**, **Stop**, **File issue**. | |
| 578 | | **Sound** | A soft chime with each pop-up, in this browser, if you turn it on. | |
| 579 | | **Counts** | The rail's Chat badge and each conversation's unread and mention counts update live, in every open tab. | |
| 580 | | **Browser notifications** | Turn them on, and this browser shows a notification when you're away from g1t, even with every tab closed. g1t never pushes to a browser where you're already looking at g1t. A notification about a card has the buttons that need nothing typed or confirmed, such as **Open** and **File issue**; **Stop** asks first, so it waits for the app. | |
| 581 | |
| 582 | ### Choose what you hear about |
| 583 | |
| 584 | Open **Settings → Notifications** (`g1t.sh/settings/notifications`): |
| 585 | |
| 586 | | Notify me about | You hear about | |
| 587 | | --- | --- | |
| 588 | | **DMs and mentions** (the default) | Direct messages, mentions, replies in your threads, agents waiting on you, and approvals. | |
| 589 | | **Everything** | Every message in conversations you're in, and everything in your inbox. | |
| 590 | | **Nothing** | No pop-ups or browser notifications. Counts still update. | |
| 591 | |
| 592 | Under **For a workspace**, you can give one workspace a different level, |
| 593 | such as **Everything** for a small team and **DMs and mentions** for a big |
| 594 | one. **Send a test notification** shows you what one looks like. |
| 595 | |
| 596 | ### Pause notifications |
| 597 | |
| 598 | From the menu on your avatar, **Pause notifications** for 30 minutes, an |
| 599 | hour, or until tomorrow morning (9:00 your time). Until then nothing pops |
| 600 | up and no browser notification is sent, whatever your settings; counts and |
| 601 | your inbox still update, and everyone sees your amber dot. **Resume |
| 602 | notifications** ends it early. |
| 603 | |
| 604 | [Your inbox](/guides/inbox/) is separate: it keeps every item until you |
| 605 | deal with it, whatever these settings say. |
| 606 | |
| 607 | ## Coming soon |
| 608 | |
| 609 | These are planned and not built yet: |
| 610 | |
| 611 | <CardGrid> |
| 612 | <Card title="Cards for everything" icon="layout-list"> |
| 613 | Pull requests, checks, deploys and approvals as cards in the channels |
| 614 | linked to a project, with their buttons working in place. <Soon /> |
| 615 | </Card> |
| 616 | <Card title="Mentions in your inbox" icon="inbox"> |
| 617 | Mentions and approvals as items in [your inbox](/guides/inbox/), so |
| 618 | acting in either place settles both. <Soon /> |
| 619 | </Card> |
| 620 | <Card title="Files" icon="paperclip"> |
| 621 | Files uploaded to a conversation, under the workspace's file rules. |
| 622 | <Soon /> |
| 623 | </Card> |
| 624 | <Card title="Your chat app" icon="messages-square"> |
| 625 | Keep the chat app your company already lives in and use your agents |
| 626 | there. See [agents in your chat app](/guides/chat-app/). <Soon /> |
| 627 | </Card> |
| 628 | <Card title="Search" icon="search"> |
| 629 | Messages in [site-wide search](/guides/search/), with only what you can |
| 630 | read. <Soon /> |
| 631 | </Card> |
| 632 | <Card title="Desktop and mobile apps" icon="smartphone"> |
| 633 | Installable apps with notifications. <Soon /> |
| 634 | </Card> |
| 635 | </CardGrid> |
| 636 | |
| 637 | ## Next |
| 638 | |
| 639 | - [Agents](/guides/agents/): create one, give it a job and a voice, and set |
| 640 | its budget. |
| 641 | - [What agents can do for whom](/guides/agent-access/): how an agent's |
| 642 | answers depend on who is asking and who can read them. |