git404hub

what is xarc fr?

getaskclaw/xarc — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A local command-line tool that lets you search, browse, and export your X (Twitter) data archive without uploading anything.

vibe map

mindmap
  root((XArc))
    What it does
      Indexes X archive
      Local search
      Export results
    Tech stack
      Python
      SQLite FTS5
    Use cases
      Search old posts
      Browse timeline
      Export data
    Audience
      Developers
      Privacy users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Search through years of your own X posts and Note Tweets locally without uploading them anywhere.

VIBE 2

Browse your X timeline offline, filtering by date range, post type, or account.

VIBE 3

Export search results or a filtered timeline to markdown, JSON, or CSV files for later use.

what's the stack?

PythonSQLiteFTS5

how it stacks up fr

getaskclaw/xarc0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Linux or WSL and Python 3.11 or newer, native Windows is not supported.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

in plain english

XArc is a command line tool for browsing, searching, and exporting an X (formerly known as Twitter) data archive entirely on your own computer. It never uploads your data anywhere. Instead it builds a local SQLite database with full text search support, covering your posts, Note Tweets, and Articles, so you can look through your timeline, read the context around a post, and find any local media files that belong to it. The original archive files are never changed or copied. It runs on Linux or WSL with Python 3.11 or newer, and needs a build of SQLite that supports the FTS5 search extension. Native Windows is not supported yet because the tool relies on a Linux only file locking feature to keep the index safe and read only. There is no network access and no third party dependencies at runtime. To use it, you unpack your X archive, copy the example config file, point it at the archive's root folder, then run the build command to create the index and the stats command to see a summary. It can also be installed into a Python virtual environment so you can run it as a plain xarc command instead of a longer module path. The tool offers commands for listing accounts, searching post text or file names, browsing a filtered timeline by type, date, and order, viewing a single post with its thread and media, checking configuration and index health, and exporting search or timeline results to markdown, JSON, or CSV files. Multiple X accounts can be merged into one database or kept in separate ones, and most commands can be limited to a single account. Exports go to a dedicated folder by default and will not overwrite existing files unless told to. Search today is lexical only, matching exact words or literal substrings, with a semantic search mode planned but not yet built. The project also documents which private data, such as direct messages and account security information, is recorded only as file paths and never indexed or exported. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me set up XArc to index my X archive and search my old posts from the command line.
prompt 2
Show me the xarc command to export all my posts about a specific topic to a markdown file.
prompt 3
Explain how to merge multiple X accounts into one XArc database and search across all of them.
prompt 4
Walk me through installing XArc in a Python virtual environment so I can run it as the xarc command.

Frequently asked questions

what is xarc fr?

A local command-line tool that lets you search, browse, and export your X (Twitter) data archive without uploading anything.

What language is xarc written in?

Mainly Python. The stack also includes Python, SQLite, FTS5.

What license does xarc use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is xarc to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is xarc for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.