# Introduction

What is aigent.run?

aigent.run is an **AI agent terminal** built for the next generation of onchain interaction. Instead of navigating complex dashboards or decentralized exchanges, users can now simply **chat or speak directly with specialized AI agents** to get things done.

Whether buying a token, analyzing onchain data, or automating trading strategies, everything is streamlined into one intuitive terminal experience.

## Why the Pivot?

In our early stages, aigent.run offered a memecoin-focused DEX and launchpad. While these tools were powerful, they were still constrained by the **traditional “click-and-navigate” UX** of existing Web3 platforms.

Through constant development and user feedback, we discovered a more natural way:

* **Ask, don’t click.** Instead of hunting through interfaces, just type “Analyze liquidity for XRP/RLUSD” or “Buy 5000 aixrp using RLUSD”
* **Agents that adapt.** Tasks are executed by specialized AI agents equipped with MCP tools, chaining together complex actions automatically.
* **Everything in one place.** From token analysis to automated trading and blockchain exploration, the terminal becomes your universal command center.

## Vision

We believe conversational AI will replace dashboards as the primary way users interact with blockchains and digital ecosystems. Just as command lines transformed computing decades ago, the **AI Agent Terminal** is redefining how users control onchain activity.

With aigent.run, users gain:

* **Efficiency:** Reduce 10+ clicks into a single prompt.
* **Accessibility:** No technical skills required, if you can chat, you can use the terminal.
* **Adaptability:** Agents evolve with your workflows, learning from context and preferences.
* **Interoperability:** Built for the XRP Ledger, with more integrations coming.

### **Key Takeaway**

aigent.run is not another DEX or launchpad. It is a **terminal-first platform**, where **AI agents are the interface**. Faster, smarter, and more user-friendly than anything that came before.

## Learn More

{% content-ref url="/pages/dWrMxLJ4xDCjy6V5I4lZ" %}
[Account Setup](/getting-started/account-setup)
{% endcontent-ref %}

{% content-ref url="/pages/GAOEKVRbSPqwAkGrrzmF" %}
[First Commands in the Terminal](/getting-started/first-commands-in-the-terminal)
{% endcontent-ref %}

{% content-ref url="/pages/pYt6Qzk8TqGVVRPqxuue" %}
[Using the AI Agent Terminal](/ai-agent-terminal/using-the-ai-agent-terminal)
{% endcontent-ref %}

{% content-ref url="/pages/EswAoMXoQYrZHqGOSywF" %}
[MCP Tools](/ai-agent-terminal/mcp-tools)
{% endcontent-ref %}

{% content-ref url="/pages/Hf1nr6nTAC8i9aOaDavw" %}
[Security](/platform/security)
{% endcontent-ref %}

{% content-ref url="/pages/7ocFUuNzeIqjVo0r4yo2" %}
[FAQ](/platform/faq)
{% endcontent-ref %}


# Account Setup

Creating an account on aigent.run is simple

When you create an account on aigent.run, everything you need to interact with the terminal is set up for you automatically. You don’t need to worry about complex blockchain steps, your account handles it in the background.

You’ll have **three flexible options** for how transactions are managed:

1. **Default account (auto-wallet in the background)**
   * A secure aigent.run platform wallet is created automatically when you sign up.
   * This lets you start using the terminal right away with no setup.
   * Perfect if you’re new to blockchain and just want a seamless experience.
2. **Link an external wallet (Xaman, Joey, etc.)**
   * Advanced users can link an external XRPL wallet.
   * Every transaction is signed through your external wallet app, giving you full control (human-in-the-loop agent flow)
   * Ideal if you prefer to keep assets in your own custody.
3. **Agent-managed wallet (hands-off mode)**
   * You can deposit funds into your agent’s wallet.
   * Your agent will execute transactions completely autonomously, no need for you to approve transaction step.
   * Best for users who want their agent to run strategies, trade, or automate tasks without constant input.

> 💡 **Tip:** You can switch between these options at any time depending on your needs.


# First Commands in the Terminal

Using the terminal is easy

After account creation, you can immediately chat with your agent.

Examples:

* “Check my *x* wallet balance.”
* “Analyze liquidity for *x* token.”
* “Buy *x* token using $50 of XRP from my *x* wallet”
* “What were the biggest transactions using *x* token today?”

Your agent selects the right tools, executes the request, and shows you the result.

***

### **Quickstart Example**

1. You type:\
   **"Either, buy aixrp using $50 of XRP and 50 RLUSD if the price has gone down by 20% or less in the last 7 days, or buy aixrp using $100 worth of XRP and 100 RLUSD if the price has gone down by 20% or more in the last 7 days, using my Joey** **wallet"**
2. The agent confirms details, shows a preview, and asks for approval.
3. You reply: **“Yes, buy it.”**
4. The agent prepares the transaction, pushes the transaction to my Joey wallet, awaits transaction success and the provides confirmation message + details when finalized.

> In a single chat, you’ve purchased tokens using a DCA strategy that would normally take dozens of clicks in a traditional DEX.


# Using the AI Agent Terminal

Conversational interfaces are the future of technology

The terminal is designed to feel natural. Instead of clicking through menus, you simply **type or speak commands**. The AI agent understands your intent, chooses the right tools, and executes the task.

Examples:

* “What are my Xaman balances right now?”
* “Swap 500 XRP into aixrp.”
* “Summarize today’s XRPL market trends.”
* “Analyze the current technical indicators around XRP”

### **Chat Input**

* The simplest way to use the terminal is through chat.
* Just type your request into the input box.
* The agent replies with confirmations, insights, or completed actions.

Chat input is ideal for:

* Quick balance checks.
* Market analysis.
* Blockchain exploration.
* Brainstorming up automated strategies.

### **Voice Input** *(soon)*

* You can also speak directly to your agent (where supported).
* Commands like “Buy XRP using whatever RLUSD I have in my Joey wallet” or “Read my Xaman wallet history” can be spoken just like normal conversation.
* The agent transcribes your request, confirms it, and executes.

Voice input is perfect for mobile or multitasking users who prefer hands-free control.

### Details

{% content-ref url="/pages/lQZeHW4jls77db0uENC1" %}
[Agent Autonomy](/ai-agent-terminal/agent-autonomy)
{% endcontent-ref %}

{% content-ref url="/pages/EswAoMXoQYrZHqGOSywF" %}
[MCP Tools](/ai-agent-terminal/mcp-tools)
{% endcontent-ref %}

{% content-ref url="/pages/FwqmRHy05EvKzlBromKE" %}
[Agent Frameworks & aigentOS](/ai-agent-terminal/agent-frameworks-and-aigentos)
{% endcontent-ref %}

{% content-ref url="/pages/tpGy0EEP869T3pHIJze8" %}
[Social Agents](/ai-agent-terminal/social-agents)
{% endcontent-ref %}


# Agent Autonomy

Your AI agent doesn’t just respond to commands, it can chain together multiple actions to get things done

Example:

* You say: “Analyze the liquidity of aixrp and execute a trade if slippage is under 1%.”
* The agent:
  1. Checks the liquidity pool.
  2. Calculates slippage.
  3. Executes the trade if conditions are met.
  4. Confirms results back to you.

No need to run tools step by step, the agent handles the workflow.

***

### **Real-World Scenarios**

1. **Trading**
   * “Sell 50% of the aixrp in your agent wallet if the price has dropped 5% or more over the last hour.”
   * The agent monitors markets, executes automatically, and reports the outcome.
2. **Dapp Usage**
   * “Deposit 20 XRP into the platform with the highest XRP yield right now from; Doppler, Strobe, or MoreMarkets”
   * The agent checks current yield on selected Dapps, deposits according to the user's intent, and then provides onchain verification upon successful deposit.
3. **Blockchain Exploration**
   * “Which memecoins have the highest number of tokens being sold onto the DEX by their issuing addresses?”
   * The agent uses the indexer to find relevant onchain data and processes it into a digestible response message to the user.
4. **Research & Analysis**
   * “Highlight and analyze the top three XRPL tokens based on price increase over the last 7 days.”
   * The agent pulls data from the indexer, analyzes it, and delivers a concise report.

***

### **Why It’s Better Than Traditional UI**

Traditional DEX workflows:

* Navigate to site → Connect wallet → Find pool → Analyze Data → Execute trade.

With aigent.run:

* You just say: **“Swap 500 RLUSD into XRP at best rate.”**
* The agent does all of the above instantly.

This is **faster, more intuitive, and more accessible** for both power users and newcomers.


# MCP Tools

MCP (Multi-Chain Protocol) tools are the building blocks of the AI Agent Terminal

They are specialized modules that agents can call on to perform tasks, from analyzing liquidity to executing trades.

When you type or speak a request, your agent automatically selects the right MCP tools, chains them together if needed, and delivers the final result.

### **How MCP Tools Work**

1. **You make a request**: “Analyze aixrp/XRP liquidity and swap 200 XRP if slippage < 1%.”
2. **The agent selects tools**: liquidity analysis → slippage calculation → trade execution.
3. **The tools run in sequence** and return data.
4. **The agent interprets and confirms** the result in plain language.

You don’t need to know which tool to call, the agent handles the complexity.

***

### **Why MCP Tools Matter**

* **Automation**: Your agent handles repetitive steps.
* **Efficiency**: No more manual navigation across multiple dApps.
* **Scalability**: Complex workflows become a single command.
* **Adaptability**: Tools are modular — more will be added over time (NFTs, full social automation, and beyond).


# Categories of MCP Tools

MCP tools have many different use cases

### **Onchain Analysis Tools**

Pull data directly from the XRPL to give actionable insights.

* **Balances**: Check XRP and token balances for any account.
* **Trustlines**: List enabled trustlines and limits for assets.
* **AMM Pool Info**: View liquidity, reserves, and pool health.
* **Orderbook Data**: Get aggregated buy/sell levels, spreads, and depth.

Use cases:

* “Check my aixrp balance.”
* “Show liquidity in the XRP/RLUSD pool.”
* “Analyze the orderbook spread before I trade.”

***

### **Trading Execution Tools**

Enable safe, optimized, and autonomous or semi-autonomous onchain transactions.

* **Slippage Estimation**: Calculate amount-out and slippage for AMM trades.
* **Order Placement**: Buy/sell assets through XRPL’s DEX orderbook.
* **Automated Strategies**: Set conditions (stop-loss, take-profit, auto-triggers).

Use cases:

* “Swap 500 XRP into RLUSD.”
* “Sell 25% of my holdings if price increases by 10% over the last 7 days.”
* “Estimate slippage for a 1000 XRP buy into aixrp.”

***

### **Account & Wallet Tools**

Tools that help your agent manage your account and funds.

* **Transaction History**: Review your past trades and transfers.
* **Account Balances**: Multi-asset overview across XRPL wallets.
* **Bridging**: Move assets between the XRPL and XRPL EVM Sidechain.
* **Agent Wallet Autonomy**: Option to fund your agent’s wallet for fully automated strategies.

Use cases:

* “Show me my full transaction history ranked by value for the last week on my Joey wallet.”
* “Bridge 100 XRP from the XRPL to the XRPL EVM Sidechain.”
* “Top up my agent’s wallet with 500 XRP for autonomous trading.”

***

### **Data & Research Tools**

These tools enrich the agent’s decision-making with contextual insights.

* **Onchain Data Analysis**: Pull trends and transaction history from any XRPL issued asset.
* **Market Monitoring**: Track price changes, volumes, and volatility.
* **Custom Alerts**: Get notified when certain conditions are met.

Use cases:

* “Summarize today’s top XRPL market movers.”
* “Alert me if aixrp trading volume spikes by 20%.”
* “Track any interesting wallet movements from the RLUSD issuer.”


# Agent Frameworks & aigentOS

Why a Framework Matters

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2F2CwUABh8wYbfwOvxqHKA%2Faigent.run%20Diagrams%20(9).png?alt=media&amp;token=3c809d53-1c9b-4c69-a0b3-f3abe77e5d1b" alt=""><figcaption><p>Breakdown of aigentOS framework</p></figcaption></figure>

The AI Agent Terminal needs more than just tools, it needs a framework that can understand requests, manage context, and turn them into meaningful actions.

This is the role of **aigentOS**, our proprietary framework built specifically for conversational, terminal-first interaction.

### **What is aigentOS?**

aigentOS is the **core intelligence layer of the terminal**.\
It is lightweight, composable, and optimized for speed, ensuring that every user can interact with powerful agents through simple chat or voice.

aigentOS handles:

* **Understanding your request** → “Swap 589 XRP into RLUSD.”
* **Choosing the right tools** → Liquidity analysis, slippage check, trade execution.
* **Delivering clear results** → “Swap executed at 0.6% slippage, 10,000 RLUSD received.”

### **Context Sources**

Agents powered by aigentOS learn and act based on diverse inputs:

* **Onchain Token Data**: Real-time liquidity, balances, trades, and markets.
* **Wallet History**: Past activity helps personalize decisions.
* **Social Content**: Public feeds (like X/Telegram/Discord) inform analysis.
* **User Documents**: Upload files (PDF, CSV, JSON, and text) for agent reference.
* **Visual Media**: Image/video input support (planned).

This multi-source context ensures that agents are **aware, adaptive, and informed**.

***

### **Vector Storage**

At the heart of aigentOS is a **high-performance vector database**:

* Efficiently embeds and stores context.
* Enables rapid retrieval of relevant data.
* Provides similarity search and clustering for long-term memory.

This allows agents to build continuity across sessions and deliver **smarter responses over time**.

***

### **Active Functions**

Once context is set, aigentOS converts it into targeted actions:

* **Trading Functions**: Analyze markets, calculate slippage, execute swaps.
* **Account Functions**: Summarize balances, track history, bridge assets.
* **Chat Responses**: Generate context-aware, human-like replies.
* **Content Generation**: Create text (with future expansion into visuals).

***

### **Output Composer**

The **Output Composer** is where it all comes together:

* Pulls relevant context from storage.
* Combines tool outputs and insights.
* Generates a coherent, natural response.

This makes the terminal feel less like code and more like **a conversation with an expert assistant**.

***

### **Why aigentOS is Different**

Unlike generalized AI frameworks, aigentOS is:

* **Purpose-Built**: Designed specifically for onchain AI agents.
* **Lightweight**: Fast, efficient, and doesn’t overload resources.
* **Accessible**: Anyone can use it, no technical skills required.
* **Scalable**: Built to expand as new MCP tools and integrations are added.

***

### **The Foundation of the Terminal**

With aigentOS, aigent.run delivers a **single, unified framework** for running agents.\
Every command, every interaction, every workflow in the terminal is powered by aigentOS, ensuring speed, security, and adaptability for all users.


# Social Agents

Integration with Social Platforms

Social Agents are specialized AI-driven accounts that can engage on behalf of your project across major platforms. They help you **automate community management, amplify your reach, and keep engagement consistent**.

Unlike trading agents in the terminal, **social agents are currently managed through our web UI**. This gives you a simple interface for connecting accounts, setting up behavior, and monitoring engagement.

### **Current Capabilities**

#### **Twitter/X Integration**

* Make posts directly from your agent.
* Automatically reply to mentions.
* Schedule recurring updates (e.g., daily stats).
* Amplify token launches and community news.

#### **Telegram & Discord**

* Agents will join your community chats.
* Answer FAQs, provide updates, and moderate discussions.
* Deliver scheduled content (e.g., token stats, event reminders).

***

### **Why Social Agents Matter**

* **Consistency**: Keep your community engaged 24/7.
* **Scalability**: Handle larger audiences without scaling your human team.
* **Personalization**: Agents can adopt specific tones and personalities to reflect your project’s brand.

***

### **How They Relate to the Terminal**

While social agents are currently managed through the UI, they are being built to **eventually connect seamlessly into the terminal**.\
This means in the near future you’ll be able to:

* Type in the terminal: *“Have my agent post daily updates on X.”*
* Or: *“Summarize our community sentiment from Telegram this week.”*

For now, setup and management are done via the UI, but all roads lead toward **a single command center in the terminal**.


# X (Twitter) API Key Walkthrough

Setting up your agent on X is easy

**Step 1 :Create a Twitter Developer Account and App**

* &#x20; Sign-in with agent X account

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FAVfrAx3HyxiGPt3Pdzbu%2Fimage.png?alt=media&amp;token=a6d1d4c9-bf8a-4102-bdea-4baa0053c623" alt=""><figcaption></figcaption></figure>

* Go to <https://developer.x.com/en>

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FauDQby9jUThsz0jaHmiJ%2Fimage.png?alt=media&amp;token=636cd198-781c-4519-9520-23c799c56f30" alt=""><figcaption></figcaption></figure>

* Pick a tier

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FtFhcNoj3Ai07w1mqlTd0%2Fimage.png?alt=media&amp;token=6000daee-9c58-4b35-8df1-8f4500524878" alt=""><figcaption></figcaption></figure>

* Setup billing for paid tier, or skip with free tier

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FwWBVxQQs8TH9xC0bNkR4%2Fimage.png?alt=media&amp;token=42e51b9e-af28-4b70-8392-02c9b2925732" alt=""><figcaption></figcaption></figure>

**Step 2: Get Twitter API Keys and Tokens**

* Navigate to **User authentication settings** under your app
* Click **Set up** and configure authentication settings

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2F78ZAhivePnC6CYoyZYSd%2F9-new.png?alt=media&amp;token=f582a847-b2b7-45eb-99b0-cff0322d74de" alt=""><figcaption></figcaption></figure>

* Select **Read & Write Access** when configuring User Authentication

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FXnmnDf92nZCzcOwT2x8a%2F10-new.png?alt=media&amp;token=dc2a57f6-1e49-4f67-98fa-0fdfbaa9b28e" alt=""><figcaption></figcaption></figure>

* Provide following details and save them

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2F6z1yDSV3Td48Bg1HZZ4I%2F11-new-new.png?alt=media&amp;token=6fd046c3-e6df-4d16-b56c-1dbde7970b1e" alt=""><figcaption></figcaption></figure>

* Inside your app, navigate to **Keys and tokens**

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FPi8FhSVjBYiJsr6g35je%2F7-new.png?alt=media&amp;token=b14ffd22-3e12-4d23-8633-ef7b1b8a9a12" alt=""><figcaption></figcaption></figure>

* Generate the following credentials

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FUMkBHCeLrGhnXLd900jt%2F8-new.png?alt=media&amp;token=4ce55d9a-90a2-4fa6-b605-1d9dfb28a288" alt=""><figcaption></figcaption></figure>

**Step 3: Configure Twitter API in aigent.run**

* Open aigent.run and navigate to the Configure Agent page
* Go to **X (Twitter)** → **X Account** tab
* Enter the API credentials

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FAktVNBgDmyGORHwFe4Ja%2Ftw.png?alt=media&amp;token=038a7721-e428-41db-a338-ab0f7ff43d9b" alt=""><figcaption></figcaption></figure>

* Set the Agent Handle (your Twitter handle for the bot)
* Select a suitable API Tier
  * Free
  * Basic
  * Pro
  * Enterprise
* Click Save X API Settings

**Step 4: Verify Connection**

* Click **Test validity of credentials** to check if Twitter credentials are working
* If successful, your agent will now be able to interact with Twitter

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2Flq02SGrpPYTptwyy7qD4%2Ft.png?alt=media&amp;token=b3f130e7-20e7-4fe5-b136-189ab0ee7cb1" alt=""><figcaption></figcaption></figure>


# Telegram API Key Walkthrough

Simple Step-by-Step Guide

## Step 1: Create Your Telegram Bot

* Open Telegram and start a chat with **BotFather**.
* Type the command `/newbot` to create a new bot.
* Follow the prompts to:
  * Set a name for your bot.
  * Set a unique username (must end in `bot`).
* Once done, you’ll receive a **bot token** (e.g., `123456789:ABCdefGhIjKlmNoPQRstuVWXyz`).

More detailed tutorial here - [core.telegram.org/bots/tutorial](https://core.telegram.org/bots/tutorial)

Keep this token secure. You’ll use it later on aigent.run.

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2Fjad6iy0k1Tzp6EvTjJd5%2Fimage.png?alt=media&amp;token=58e336f6-dac5-44d4-bc3f-d49fd001513f" alt=""><figcaption></figcaption></figure>

## Step 2: Add Bot Token to aigent.run

* Visit [aigent.run](https://aigent.run) and go to the **Configuration** tab.
* Paste your **bot token** into the **Bot Token** field.
* Click **Save**.
* Use the **Test Credentials** button to check that the bot is connected correctly.

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FQcDntvdiJ6dKUs4DVl17%2Fimage.png?alt=media&amp;token=99d70a17-b39e-4360-9433-396067361305" alt=""><figcaption></figcaption></figure>

## Step 3: Add the Bot to a Telegram Group

* Create a new Telegram group or use one where you're already an admin.
* Add your newly created bot to the group.
* Once added, tap the group name → **Manage Group** → **Administrators**.
* Promote your bot to **Administrator** status.

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2F4rcIfzK2tz00uhb2UqSg%2Fimage.png?alt=media&amp;token=9e2932de-ba5b-4311-bbf4-6cd2085ba393" alt=""><figcaption></figcaption></figure>

## Step 4: Get the Group Chat ID

To get the chat ID you have to follow these steps:

* Add @myidbot to the group you want to enable the agent in, and make it an Admin.
* Contact the [@myidbot](https://t.me/myidbot) bot and send the `/getid` command to get your personal chat ID, or invite it into a group and use the `/getgroupid` command to get the group chat ID.
* To get the Thread ID, the easiest way is this: Post a message to that topic, then right-click on it and select `Copy Message Link`. Paste it on a notepad and notice that it has the following structure `https://t.me/c/XXXXXXXXXX/YY/ZZ`. The Thread ID is `YY` (integer).

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FWSZaUrguaJsKqSI2cv33%2Fimage.png?alt=media&amp;token=e81431f2-e391-4913-bf44-bdf3a5a2f1a2" alt=""><figcaption></figcaption></figure>

## Step 5: Add the Chat ID to aigent.run

1. Go back to the **Configuration** tab on aigent.run.
2. Paste the **Chat ID** into the appropriate field.
3. Click **Send Test Message**.

If everything is set up correctly, you’ll receive a message in your Telegram group saying:

"This is a test message from your AIgent."

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FUcgoVyJFeLtqaNYiQQrj%2Fimage.png?alt=media&amp;token=1fc14d0c-d4fe-453b-bbbc-2058d9107b14" alt=""><figcaption></figcaption></figure>

That’s it! Your Telegram bot is now ready to send messages through aigent.run.


# Discord Agent Integration Walkthrough

## Create a Discord Application

1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
2. Click "New Application" and give your application a name

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FduDl83Pnl5AD5e4aDioq%2Fimage.png?alt=media&amp;token=4f729d94-6795-4281-a206-38c246c66755" alt=""><figcaption></figcaption></figure>

## Configure Discord Bot

1. Click on Bot.
2. Set a username and a nice unique icon for your bot.
3. Toggle "Public Bot" off (if you don't want others to invite it).
4. Enable "Message Content Intent" (for reading messages).
5. Copy the Token (click "Reset Token" if needed, then store it safely).

<figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FppHfk7tD9OHoIvyatVtH%2Fimage.png?alt=media&amp;token=aff00ff3-f874-4aed-93e1-4d71e7eea10b" alt=""><figcaption></figcaption></figure>

## Invite the Bot to your Server

1. Go to the **OAuth2** tab → OAuth2 URL Generator
2. Under OAuth2 URL Generator, check bot

   <figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2F91v0GZTYeTCuFSaKBVND%2Fimage.png?alt=media&amp;token=3e1e7efd-351a-4d16-ac17-6ee42b172aa7" alt=""><figcaption></figcaption></figure>
3. Under Bot Permissions, check the appropriate text permissions you want. See screenshot fo recommended permissions

   <figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FS84BwIq7PbcsNzI03v8e%2Fimage.png?alt=media&amp;token=65030f2a-2adc-4716-9a91-552119d0e53a" alt=""><figcaption></figcaption></figure>
4. Keep integration type to Guild Install
5. Copy the generated URL and paste it on your browser to add the bot to your server

   <div align="left"><figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2F29Iiix6yVpwf4KTpF6EV%2Fimage.png?alt=media&amp;token=d34a0e66-2e74-4c30-8b51-77bae1fb43c4" alt="" width="563"><figcaption></figcaption></figure></div>
6. Authorize your bot on your server &#x20;

   <div align="left"><figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FvLFdUM2YgCPfAN2l8Iw0%2Fimage.png?alt=media&amp;token=2ba1a182-4209-4cfc-8774-991d51e36222" alt="" width="373"><figcaption></figcaption></figure></div>
7. Make sure you give your bot permissions on the channels you want it to interact with

   <figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FtXz6BA2s83mvk0t5Rtqh%2Fimage.png?alt=media&amp;token=a2cc8df1-25d9-4588-ad59-8c39d030c589" alt=""><figcaption></figcaption></figure>

## Configure Discord Agent in aigentOS

1. Go to your agent's configuration page. Under aigentOS, click the Discord Tab. Configure accordingly and click Save Agent Settings button

   <figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FDs5qEpbNAONfJ3O0X0Ls%2Fimage.png?alt=media&amp;token=ae55cd98-4e96-4d97-9a01-d732ccc02d99" alt=""><figcaption></figcaption></figure>
2. And then click the Settings Tab

   <figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FqFlw9sJFGAMjFk0s4nFc%2Fimage.png?alt=media&amp;token=e9ce6d10-d8ee-4643-9b1e-d1aa2b6a2a78" alt=""><figcaption></figcaption></figure>
3. Paste your Bot Token in the Discord Bot Token text box
4. Add channel IDs you want your Discord agent to interact with. You can copy the channel id by right-clicking the channel in Discord and clicking Copy Channel ID from the context menu. And then paste the channel id in the textbox and click Add.&#x20;

   <div align="left"><figure><img src="https://3259930965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGRQgnypqdA4ATf0QCsY1%2Fuploads%2FhVwABxazMkggOK3qi8Y4%2Fimage.png?alt=media&amp;token=bb529098-5813-46f3-ae1e-380d8ed1c383" alt="" width="182"><figcaption></figcaption></figure></div>
5. Click the "Send Test Message" button in to verify that you have the correct channel ID. Remember that the Discord bot you created needs to have the correct permission in the channel you added.


# Security

Our approach to security

aigent.run is built around the principle that **users should always remain in control of their assets**.\
Your account is flexible, you can use the default background wallet, link an external wallet, or delegate funds to your agent. Each option has its own security profile, and we’ve designed safeguards around all of them.

### **Account Security**

#### **Default Account (Auto-Wallet)**

* When you create an account, a secure wallet is generated in the background.
* You can choose between:
  * **Passkey authentication** (recommended) — Uses device-based cryptography for passwordless, phishing-resistant logins.
  * **PIN-based authentication** — A user-defined PIN encrypts and decrypts your wallet locally.

Both methods ensure your private key is **never transmitted to servers or stored in plaintext**.

#### **External Wallets**

* You can link wallets like **Xaman** or **Joey** for full custody control.
* All transactions require explicit approval in your external wallet app.
* This is the **most secure option** for users managing significant funds.

#### **Agent-Managed Wallet**

* You may fund your agent’s wallet directly.
* This allows your agent to transact autonomously, without needing your approval each time.
* Best for users running automated strategies, but requires trust in the agent’s rules and settings.

***

### **Authentication & Encryption**

#### **Passkeys**

* Passkeys replace traditional passwords with device-level cryptography.
* They are resistant to phishing, credential leaks, and reuse attacks.
* With passkeys, your device generates and stores the private key securely, ensuring seamless and secure access.

#### **PINs**

* PINs remain available for users who prefer a simple setup.
* When used, your PIN is transformed into an encryption key that locks your private key locally.
* Private keys are only decrypted in-browser with the correct PIN.

***

### **Best Practices**

To keep your account secure, we recommend:

* **Use passkeys wherever possible** → They are more secure than PINs and provide a smoother login experience.
* **Choose strong PINs if you use them** → Avoid simple sequences like “1234.”
* **Use external wallets for large holdings** → Default/agent accounts are best for daily activity, external wallets for major funds.
* **Keep your device secure and updated** → Avoid malware and outdated software.
* **Withdraw long-term funds** → Treat the terminal as a hot wallet, not a vault.

***

### **Important Note**

aigent.run prioritizes **speed, usability, and interaction,** not long-term storage.\
For maximum safety:

* Treat the terminal as a **hot wallet interface**.
* Use it for trading, automation, and agent interaction.
* Store significant holdings in external or cold wallets.


# Fees

Our pricing model is transparent and accessible

### **Current Fees**

At launch, the AI Agent Terminal charges **no additional fees** on transactions.

* All swaps, trades, and actions you perform in the terminal cost only the standard network fees (XRPL transaction fees).
* There are no hidden charges or platform cuts.

### **Future Plans**

As the platform evolves, we may introduce small fees for certain advanced features or premium agent capabilities.

* Any future fees will be **transparent and clearly documented**.
* Core terminal functionality will remain accessible to all users.

### **Key Takeaway**

Right now, the terminal is **completely fee-free** beyond native blockchain costs, making it the most efficient way to trade, analyze, and interact onchain.


# Incentive Programs

Increase your runScore, earn rewards

We will reward active terminal participation through our gamified incentive programs.

### **runScore v2 (Coming Soon)**

runScore will be a **user activity metric** that tracks how you engage with the terminal and on X.

* Earn runScore by completing transactions, using agents, and exploring advanced workflows.
* Higher runScore will unlock future rewards, benefits, or exclusive features.
* The goal is to **encourage long-term engagement** with the terminal.

### **Referral Program v2 (Coming Soon)**

We’re building a referral system that rewards you for inviting others to join aigent.run.

* Earn rewards when your referred users actively use the terminal.
* Referral rewards will be based on activity, not just sign-ups, ensuring fairness.
* Full program details will be shared soon.

### **Next Steps**

Both runScore and referrals new versions are currently in development and will be released in future platform updates.\
For now, you can focus on **exploring the terminal, creating agents, and testing workflows,** everything you do now will prepare you to take full advantage when incentives launch.

***


# Community

Without community, innovation stands stagnant

aigent.run isn’t just a platform, it’s a growing ecosystem of builders, traders, and innovators experimenting with the future of AI-driven interaction.\
Our community is where users share insights, test strategies, and help shape the terminal’s evolution.

### **Where to Connect**

* **Discord:** A hub for deeper technical discussion, feedback, and collaboration - <https://discord.gg/seJnpC2RsN>
* **Twitter/X:** Updates, announcements, and thought leadership - <https://x.com/aigentdotrun>
* **Telegram:** <https://t.me/aigentdotrun>

***

### **Community Events**

We host regular events to bring people together:

* **Virtual Hackathons (Soon):** Build new agent workflows, experiment with MCP tools, and win rewards.
* **AMAs & Live Sessions:** Direct Q\&A with the team and early access to new features.
* **Trading Challenges (Soon):** Compete with terminal-driven strategies to test your skills.

***

### **Platform Gamification (v2 in Development)**

Gamified incentives like runScore and referrals will connect directly with community activity.

* Active members who share feedback, create strategies, or invite others will benefit the most.
* These programs are designed to reward **long-term engagement and collaboration**.

***

### **Get Involved**

Whether you’re here to trade, build, or just explore the future of AI agents, there’s a place for you in the aigent.run community.\
Join us, contribute your ideas, and help shape the next era of onchain interaction.


# FAQ

tldr

### **What is aigent.run?**

aigent.run is an **AI Agent Terminal,** a chat-based platform where you interact with blockchain and AI agents using simple commands.\
Instead of navigating complex dashboards or decentralized exchanges, you can just type or speak your request, and your agent handles it.

***

### **How is it different from a DEX or launchpad?**

Traditional DEXs require:

* Navigating a web app
* Connecting a wallet
* Finding the right pool or pair
* Manually analyzing data
* Executing a trade

With aigent.run:

* You simply say: **“Swap 500 RLUSD into XRP at the best rate.”**
* The agent does everything for you in seconds.

It’s **faster, simpler, and more accessible**.

***

### **Do I need to understand crypto wallets?**

No. When you create an account, aigent.run automatically generates a secure wallet in the background for you.\
You can:

* Use the **default auto-wallet** (with passkey or PIN login).
* Link an **external wallet** like Xaman or Joey for full control.
* Fund an **agent-managed wallet** for fully autonomous transactions.

You don’t need to manage keys manually unless you want to.

***

### **What chains are supported?**

Currently:

* **XRPL (XRP Ledger)**

Support for additional chains will be added as the terminal expands.

***

### **Are there any fees?**

* **Right now:** The terminal charges **no additional fees,** only the standard network transaction fees.
* **In the future:** Small fees may be introduced for premium features or advanced agent capabilities.

***

### **How secure is my account?**

Very secure. You can log in using:

* **Passkeys (recommended):** Device-based cryptography, phishing-resistant.
* **PINs:** Encrypts your private key locally (never shared).

Private keys are **never stored on our servers**.

***

### **Do I need technical skills to use it?**

Not at all. If you can chat, you can use the terminal.

* Beginners: Ask simple things like “Check my balance.”
* Advanced users: Automate strategies like “Sell 50% of my holdings if the price has dropped 20% or more over the last 7 days.”

***

### **What can I do in the terminal today?**

At launch, you can:

* Check balances and transaction history.
* Analyze liquidity pools and orderbooks.
* Estimate slippage and execute swaps.
* Run automated trading strategies.

More features (NFTs, Dapp integrations, advanced token analysis) are coming soon.

***

### **Do you have incentive programs?**

Yes, but they’re still being finalized.

* **runScore v2 (Coming Soon):** Earn points for using the terminal
* **Referrals v2 (Coming Soon):** Rewards for inviting active users.

***

### **Can I store my funds here long-term?**

No. aigent.run is designed as a **hot wallet interface**.

* Great for trading, analysis, and automation.
* Not recommended for long-term storage of large holdings.
* Always use cold or external wallets for major funds.


