Connecting your X account

Connect your X (Twitter) account and Monad can read posts and post on your behalf — search, look up people, read timelines, and (when you ask) post, reply, like, and follow as you. While the connection is active, Library also maintains a read-only mirror of supported X objects so related clusters stay current.

Setting it up#

X requires your own developer app, so connecting takes a one-time setup:

1. Open Settings → My Connections and find X (Twitter) in the Connectors section. Click Add to open the connector's page. (If your workspace admin already set X up, you can also reach it from Settings → Connection Preferences.)
2. On the connector's page, look under Your account. If your workspace admin has already set X up, you'll see a Connect button — skip to "Connecting" below.
3. Otherwise, create an OAuth 2.0 app in the X developer portal, register the callback URL shown in the form, then paste your app's Client ID and Client Secret and choose Save & connect.

Connecting#

Click Connect. You'll be taken to X to authorize, then returned with a green Connected badge showing your @handle. From then on, you can ask an agent things like "what are people saying about our launch?" or "reply to that mention" without thinking about credentials.

Once X is connected, its card turns into a dimmed Added tile and it appears in your Connections list above — open it from there any time to manage tools or disconnect.

What Monad can do#

Once connected, Monad acts as your account. It can read — search posts, look up people, read timelines, and check your mentions — and, when you ask, post, reply, repost, like, follow, and delete. Posts, replies, reposts, and follows are public and immediate, and deleting a post is permanent, so be clear about what you want done; your agent will confirm anything public or irreversible with you first.

To keep an eye on a set of people over time, ask your agent to put them in an X List — it can then check everyone's recent posts in one pass on a schedule, and add or remove people from the List as your interests change.

Choosing which tools Monad can use#

Once connected, the connector's page shows a Tools list with a switch for each thing Monad can do (post, search, look up people, and so on). Turn a tool off and Monad stops using it on its next run; turn it back on to allow it again. New tools added later are on by default.

Read-only tools appear first, followed by tools that can change X; each group is alphabetical.

• A writes badge marks a tool that changes things on X (posting, replying, deleting) rather than just reading — handy when you want to leave reading on but switch writing off.
• A tool shown as off and locked with disabled by workspace was turned off for everyone by an admin; you can't re-enable it yourself.

These switches control agent tools. They do not pause Library's read-only mirror; disconnect X to stop both uses of the connection.

You'll also see a short Description of the connector — a plain-language summary Monad reads to decide when X is the right tool for a task. It's written for you automatically and may take a moment to appear the first time you open the page.

How X appears in Library#

A personal X connection creates Only you Library objects. A shared corporate connection creates workspace-visible objects. Library keeps mirrored posts and other supported state current and may use them in eligible clusters.

You can promote an eligible object from a personal connection without sharing your whole account: open the object's Monad detail page and choose Share to workspace. The action is recorded, and that object can then contribute to workspace clusters. Choose Revoke share to return it to Only you; Library removes its workspace memberships and grounded claims as it rebuilds the affected clusters. Sharing through Library does not post anything to X or change the object's visibility on X.

Reconnecting#

If you see an amber Reconnect needed badge, your access expired or the credentials changed. Click Reconnect and authorize again, or choose Disconnect to remove your connection without reconnecting first.

Disconnecting#

Click Disconnect at any time. Monad immediately stops using your X account. Library removes the connection's mirrored objects and refreshes affected clusters. To also revoke access on X's side, remove the app in your X account settings.