> For the complete documentation index, see [llms.txt](https://swarmnexus.gitbook.io/swarmnexus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swarmnexus.gitbook.io/swarmnexus/documentation/readme/user-guide/editor.md).

# How to Ingest Data into the Swarm Memory

The Swarm Memory is the collective consciousness of the Torus ecosystem, and you have the power to contribute to it directly. By ingesting data, you help create a permanent, searchable archive of valuable conversations, insights, and content.

There are two primary ways data enters the Swarm Memory: automatically and manually.

#### 1. Automatic Ingestion (Coming Soon)

Our Swarm Nexus engine is being upgraded to actively index and save any message or memory related to Torus from across the digital landscape.

* **What will be indexed?** Conversations on Twitter, discussions in Telegram, community planning on Discord, and more.
* **How does it work?** The system will identify keywords, accounts, and contexts related to the Torus Network and automatically ingest them.
* **Your role:** Simply by participating in the ecosystem, you will be contributing to the Universal Memory.

#### 2. Manual Ingestion (Available Now)

You can manually signal to the Swarm that a piece of content is valuable and should be archived. This is the most direct way to ensure a specific tweet and its surrounding context are saved.

**How to Manually Ingest a Tweet**

To have a tweet and its parent conversation ingested into the Swarm Memory, simply **reply to it and tag our official account: `@SwarmNexus`**.

**Example:**

Let's say you find a tweet from a developer that contains a brilliant insight about the future of the Torus Network.

1. Click the "Reply" button on that tweet.
2. In your reply, add the tag `@SwarmNexus`. You can add a comment if you like, or just tag the account.
3. Post the reply.

That's it! The Swarm Nexus **Collector** will see your mention in its next cycle, find the parent tweet you replied to, and save the entire conversation in the Swarm Memory.

**What Happens Next?**

* The Collector processes your mention, usually within a few minutes.
* The original tweet, its author, content, and your contribution are stored permanently.
* This action is recognized as a valuable contribution, and you will be on your way to earning **SWARM Points**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://swarmnexus.gitbook.io/swarmnexus/documentation/readme/user-guide/editor.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.