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.

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

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).

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.

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.

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.

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

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.

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 -

• Telegram:

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.

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%.”

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.”

Create a Discord Application

1. Go to

2. Click "New Application" and give your application a name

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.”

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 -

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

Step 2: Add Bot Token to aigent.run

• Visit 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.

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.

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 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

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."

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

Step 1 :Create a Twitter Developer Account and App

• Sign-in with agent X account

• Go to https://developer.x.com/en

• Pick a tier

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

Step 2: Get Twitter API Keys and Tokens

• Navigate to User authentication settings under your app

• Click Set up and configure authentication settings

• Select Read & Write Access when configuring User Authentication

• Provide following details and save them

• Inside your app, navigate to Keys and tokens

• Generate the following credentials

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

• Set the Agent Handle (your Twitter handle for the bot)

• Select a suitable API Tier

  • Free

  • Basic

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

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.

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.

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.

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.

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

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.