content/using/os/messaging.md · urbit.org

git.iko.soy/urbit.org

on 514b5fc help sign in

urbit.org/content/using/os/messaging.md

254 lines 6.6 kB history raw

1+++

2title = "Messaging"

3template = "doc.html"

4weight = 2

5+++

7Let’s get started using the `:chat-cli` application, also known more simply as

8_Chat_. It's the simplest way to talk to people using the command line

9interface.

11### Quickstart

13The most common use for `:chat-cli` right now is, of course, communicating in group chats.

15### Joining a chat

17In `:chat-cli`, any kind of medium for a message is called a _chat_. There are four "types" of chats, but for now we'll be dealing with the _channel_, a publicly accessible chatroom for general use. We'll discuss the other three kinds in the [chat management](#chat-management) section later on.

19Join the Urbit Community from Dojo using `:group-view &group-view-action [%join [~bitbet-bolbel %urbit-community] ~bitbet-bolbel]`. Once you've joined, join the General chat from chat-cli. Use `ctrl-x` to switch from the Dojo prompt to the Chat prompt.

21Then:

23```

24~sampel-palnet:chat-cli/ ;join ~darrux-landes/general

25```

27Now that you're in, try post a line to `~darrux-landes/general`:

29```

30~sampel-palnet:chat-cli= Hello, world!

31```

33You'll see your message printed below messages from others that came before it. You can always type `;chats` in the `chat-cli` prompt to list all the chats you're in:

35```

36~sampel-palnet:chat-cli= ;chats

37~darrux-landes/general

38```

40Glyphs will be automatically assigned to channels, but have the option of binding a glyph (single non-alphanumeric character) to the channel you're joining; the syntax is in the form of `;join ~/~dopzod/books +`. The chosen glyph will be the symbol that ends your prompt, and it will be what you use as a shortcut to switch to this channel.

42```

43~sampel-palnet:chat-cli= ;+

44~sampel-palnet:chat-cli+

45```

47Use `;leave` to unsubscribe from a channel:

49```

50~sampel-palnet:chat-cli= ;leave ~darrux-landes/general

51```

53Now, let's create a channel we can invite some friends to:

55```

56~sampel-palnet:chat-cli= ;create channel /my-channel

57```

59Now you can tell your friends to `;join ~your-urbit/my-channel`.

61In order to see messages in `:chat-cli` you may need to do the following in Dojo:

63```

64:chat-cli %connect

65```

66 ### Creating and managing chats {#chat-management}

68As mentioned before, any urbit can host any number of chats. Existing chats can be deleted or modified with various commands. All commands in this section should be sent from the `chat-cli>` prompt.

70#### Create

72Syntax: `;create [type] /name +`, where `+` represents an optional glyph.

74Creates and joins a chat, where `[type]` is any of the following:

75- `channel`: public chat. Has a blacklist for write control.

76- `village`: invite-only chat.

77- `journal`: publicly readable, invite-only for writing.

78- `mailbox`: publicly writeable, invite-only for reading.

80Let's create an example mailbox:

82```

83~sampel-palnet:chat-cli> ;create mailbox /coolbox ^

84```

86#### Delete