User Guide

How to import and organise your X bookmarks, hand them to an AI agent, and filter your feed by region.

1. Getting Started

OpenBird is a Chrome extension plus a web app that turns your X/Twitter bookmarks into an organised, searchable, agent-ready library — and adds region flags to your timeline.

1.
Install the extension from the Chrome Web Store.
2.
Sign in at openbird.app with X — OpenBird uses your existing X session, no password needed.
3.
Open x.com and OpenBird imports your existing bookmarks automatically into folders you control.

2. Bookmark Manager

Everything lives at openbird.app/bookmarks, accessible from any browser once you're signed in.

Folders: Organise bookmarks into folders, each with its own visibility (public, private, or unlisted).

Tags: Tag any bookmark and filter by tag. Tags are searchable.

Search: Full-text search across author names, handles, tweet content, tags, and folder names.

Bulk actions: Select multiple bookmarks to move, tag, or delete them at once.

Export: Export everything (or a single folder) as JSON or CSV.

3. Importing Your Bookmarks

Unlike tools limited by the official X API (often capped at ~25 bookmarks), OpenBird runs in your browser on your own session and imports your entire bookmark history — including your existing X bookmark folders.

Import runs automatically the first time you open x.com after signing in, and a background sync keeps new bookmarks flowing. You can also trigger a sync from the extension popup's Bookmarks tab.

Free accounts sync up to 200 bookmarks; Pro is unlimited.

4. Thread Saving

From a tweet's "..." menu, choose Save thread to save the whole thread into a folder, with the order preserved — not just the single tweet.

Thread saving is a Pro feature.

5. Metrics

The Metrics page shows analytics about your collection:

  • Total bookmarks, folders, and weekly activity
  • Most active day of the week
  • Top bookmarked authors
  • Folder breakdown and tag cloud

Metrics is a Pro feature.

6. AI Agent Access (MCP)

OpenBird ships an MCP (Model Context Protocol) server plus an OpenAPI spec, so Claude Desktop, Cursor, and ChatGPT can search, tag, organise and summarise your saved tweets — twelve tools in all, from full-text search to folder management and collection stats.

Visit the Connect page for step-by-step setup and your access key.

Agent access is a Pro feature.

7. Region Flags & Filtering

X shows which country an account is based in. OpenBird surfaces that as a flag badge next to the username, and lets you collapse tweets from countries or whole regions you choose (with a one-tap reveal).

Configure flags and blocked regions in the extension popup's Regions tab. Free covers 3 blocked regions; Pro is unlimited.

Note: X lets users display only a broad region rather than a country, so treat this as a helpful signal, not a guarantee.

8. Keyboard Shortcuts

In the bookmark manager:

Cmd + ASelect all visible bookmarks
DeleteDelete selected bookmarks
EscapeClear selection / close dialogs

9. FAQ

Does OpenBird access my X password?

No. It uses your existing browser session, the same cookies X sets when you log in normally. No password, no separate login.

Can I use multiple X accounts?

Yes. The extension works on whichever account you're logged into; your bookmarks are tied to your openbird.app account, so you can switch X accounts freely.

Where is my data stored?

Bookmarks synced to openbird.app are stored on our self-hosted servers in Germany (Hetzner) — no third-party cloud databases. Extension settings stay local in Chrome.

Can I export everything?

Yes — from Bookmarks (Export) or Settings → Data & Privacy.

Do my saves survive if the tweet is deleted?

Yes. OpenBird stores the tweet's text and metadata at import time, so your bookmark remains readable even if the original is removed.