llms.txt
# aramb
> The backend for agentic SaaS. Build, deploy and talk to AI agents from the
> console or the @aramb-ai/sdk — with projects, workspaces, sub-tenant
> isolation, toolkits, triggers and usage-based credits.
## Product
- [aramb](https://aramb.ai/): Build, deploy and talk to AI agents — from the console or the SDK.
- [Pricing](https://aramb.ai/pricing): Plans and usage-based credit pricing.
- [AWS credits](https://aramb.ai/aws-credits): Using AWS credits with aramb.
- [Support](https://aramb.ai/support): How to get help.
- [Privacy](https://aramb.ai/privacy): Privacy policy.
- [Terms](https://aramb.ai/tos): Terms of service.
- [Cookies](https://aramb.ai/cookies): Cookie policy.
## Documentation
Reference for building on aramb (25 pages).
- [What is aramb?](https://aramb.ai/docs/): aramb is an agent platform — define an agent from its identity, then talk to it from the console or the @aramb-ai/sdk, with per-user isolation and usage built in.
- [Quickstart](https://aramb.ai/docs/quickstart/): Ship your first aramb agent in minutes — from the no-code console or with the @aramb-ai/sdk.
- [Agents](https://aramb.ai/docs/concepts/agents/): An aramb agent is defined by its identity — a system prompt that is the agent. Define it once and reuse it across every user and conversation.
- [Conversations & sessions](https://aramb.ai/docs/concepts/conversations/): A session is one live conversation with an agent, scoped to a single end-user. Learn how sessions bind to conversations, resume, and stay isolated.
- [Projects & workspaces](https://aramb.ai/docs/concepts/projects-workspaces/): The aramb hierarchy — a workspace holds your agents; a project pairs one agent with one sub-tenant and owns a VM; chats (conversations) run on that project's persistent VM.
- [Sub-tenants & isolation](https://aramb.ai/docs/concepts/sub-tenants-isolation/): How aramb separates your end-users from one another under a single agent — per_user vs shared isolation, and what a subTenant is.
- [Usage & credits](https://aramb.ai/docs/concepts/usage-credits/): How aramb meters token usage per agent and per sub-tenant, and how to read it programmatically for billing and quotas.
- [Create an agent](https://aramb.ai/docs/console/create-agent/): Define an aramb agent from its identity in the console, chat with it, and publish a version — no code required.
- [Console overview](https://aramb.ai/docs/console/overview/): Build, test, and run aramb agents without writing code — projects, agents, workflows, triggers, toolkits, and schedules from the browser.
- [Scheduling & runs](https://aramb.ai/docs/console/scheduling/): Run aramb workflows on a cron schedule, and monitor, retry, or cancel their runs from the console.
- [Toolkits & connections](https://aramb.ai/docs/console/toolkits-connections/): Give aramb agents the ability to act on external services — connect GitHub, Gmail, Slack, and more via OAuth, and use them in workflows and triggers.
- [Triggers](https://aramb.ai/docs/console/triggers/): Start aramb workflows automatically when something happens in a connected tool — new GitHub issues, inbound email, and more.
- [Workflows](https://aramb.ai/docs/console/workflows/): Chain agents and steps into a repeatable, multi-step automation in the aramb console — nodes, edges, sub-agents, and run inputs.
- [Agents](https://aramb.ai/docs/sdk/agents/): Create an agent with the @aramb-ai/sdk — the createAgent surface, isolation modes, greetings, and versioning.
- [Conversations](https://aramb.ai/docs/sdk/conversations/): List, create, and read conversations with the @aramb-ai/sdk — resume a past chat, mint a new one up front, and page through transcripts.
- [Error handling](https://aramb.ai/docs/sdk/errors/): Every @aramb-ai/sdk failure throws an ArambError with a stable, machine-readable code. Learn the codes and how to handle them.
- [Events & frames](https://aramb.ai/docs/sdk/events-frames/): The aramb session lifecycle — the typed frames the gateway streams, and the events run() and stream() surface on a session.
- [Installation](https://aramb.ai/docs/sdk/installation/): Install @aramb-ai/sdk, the Node/TypeScript SDK for the aramb agent gateway, and construct a client.
- [SDK quickstart](https://aramb.ai/docs/sdk/quickstart/): A complete, runnable Express backend built on @aramb-ai/sdk — one shared agent, one session per user, streaming and awaited endpoints, plus a usage route.
- [Sessions — run & stream](https://aramb.ai/docs/sdk/sessions/): Open a session for one end-user and talk to an agent — awaited replies with run(), token streaming with stream(), serialization, and reconnection.
- [Usage](https://aramb.ai/docs/sdk/usage/): Read token usage with the @aramb-ai/sdk — getUsage across all products and sub-tenants, or scoped to a single agent or end-user.
- [REST API](https://aramb.ai/docs/api/rest/): Talk to the aramb gateway directly over HTTP and WebSocket — endpoints, authentication, and the streaming protocol.
- [SDK reference](https://aramb.ai/docs/api/sdk-reference/): Everything the @aramb-ai/sdk exports — every method with its parameters, return types, and errors.
- [Pricing](https://aramb.ai/docs/resources/pricing/): How aramb bills — credits consumed per run, tracked per agent and per end-user.
- [Troubleshooting](https://aramb.ai/docs/resources/troubleshooting/): Diagnose and fix common issues with aramb agents and the @aramb-ai/sdk — auth, quotas, connections, streaming, and isolation.
## Use cases
Ready-to-run agent templates (202).
- [Automate bookkeeping from receipts](https://aramb.ai/use-cases/ai-agent-to-automate-bookkeeping-from-receipts/): Snap a receipt in Telegram. Get a coded, reconciled ledger entry, without the manual data entry.
- [Monitor company risk automatically](https://aramb.ai/use-cases/ai-agent-to-monitor-company-risk-automatically/): Official filings, read daily. Get alerted the day a company you track shows risk.
- [Automate your X ghostwriting](https://aramb.ai/use-cases/ai-agent-to-automate-your-x-ghostwriting/): A week of posts in your voice, drawn from live conversations in your niche, with no repeats.
- [Automate real estate cold calling](https://aramb.ai/use-cases/ai-agent-to-automate-real-estate-cold-calling/): A compliant power-dialer session that prioritises leads, respects the rules, and logs every outcome.
- [Analyze customer churn automatically](https://aramb.ai/use-cases/ai-agent-to-analyze-customer-churn-automatically/): A weekly churn readout that counts the money, not the logos, and tells you when a week is too thin to trend.
- [Post credit card statements to the ledger, automatically](https://aramb.ai/use-cases/ai-agent-to-post-credit-card-statements-to-the-ledger-automatically/): Drop in the statement PDF. Get a coded, tied-out journal entry against the card liability, not a weekend of data entry.
- [Audit SaaS spend from your card transactions](https://aramb.ai/use-cases/ai-agent-to-audit-saas-spend-from-your-card-transactions/): Find every recurring subscription hiding in the card feed, and put the cancellation link in the hands of the person paying for it.
- [Issue and chase placement-fee invoices](https://aramb.ai/use-cases/ai-agent-to-issue-and-chase-placement-fee-invoices/): Turn a confirmed start date into a defensible invoice, then let it chase 30/60/90 so the AR never slips.
- [Track tax law changes every day, with citations](https://aramb.ai/use-cases/ai-agent-to-track-tax-law-changes-every-day-with-citations/): Read every official tax publisher so you don't have to, and get a cited digest that ranks what actually matters to your practice.
- [Audit product compliance certificates before they expire](https://aramb.ai/use-cases/ai-agent-to-audit-product-compliance-certificates-before-they-expire/): Turn a folder of certificate PDFs into a structured expiry tracker, and never get caught by a lapsed CE or RoHS cert.
- [Monitor clinical compliance changes for your niche](https://aramb.ai/use-cases/ai-agent-to-monitor-clinical-compliance-changes-for-your-niche/): Watch the regulators and guideline bodies that govern your clinic, and get a ranked digest of what actually carries a deadline.
- [Ghostwrite a daily LinkedIn authority post](https://aramb.ai/use-cases/ai-agent-to-ghostwrite-a-daily-linkedin-authority-post/): Treat posting as a rotation problem, not a blank page: the most-overdue pillar, a fresh news peg, a draft in your voice.
- [Spy on competitor Meta ads, and find your angle gaps](https://aramb.ai/use-cases/ai-agent-to-spy-on-competitor-meta-ads-and-find-your-angle-gaps/): Let the ads that survived 30+ days tell you what's working, then get the persuasion angles your own account is missing.
- [Track your brand's visibility in AI answers](https://aramb.ai/use-cases/ai-agent-to-track-your-brand-s-visibility-in-ai-answers/): Buyers ask AI assistants before they ask you. See whether you're recommended, mentioned, or absent, and who owns the answer instead.
- [Skip-trace property owner contacts, row by row](https://aramb.ai/use-cases/ai-agent-to-skip-trace-property-owner-contacts-row-by-row/): Fill the missing phones and emails on your owner list from public records, graded and sourced, with a daily match-rate you can trust.
- [Find probate real estate leads, before your competition](https://aramb.ai/use-cases/ai-agent-to-find-probate-real-estate-leads-before-your-competition/): Watch the county dockets nobody reads, and get a ranked hot list of executors with a paste-ready outreach kit.
- [Run a compliant wholesaler power dialer](https://aramb.ai/use-cases/ai-agent-to-run-a-compliant-wholesaler-power-dialer/): Dial the list at volume without dialing into a lawsuit: DNC-scrubbed, window-aware, voicemail-dropping, fully logged.
- [Report helpdesk queue health, every morning](https://aramb.ai/use-cases/ai-agent-to-report-helpdesk-queue-health-every-morning/): Walk into standup already knowing the queue: created, resolved, open, backlog, and the themes behind them, with the math shown.
- [Detect SaaS funnel anomalies, without the false alarms](https://aramb.ai/use-cases/ai-agent-to-detect-saas-funnel-anomalies-without-the-false-alarms/): Get pinged only when a metric genuinely breaks, with an owner and a first diagnostic step, not every time Monday looks like Monday.
- [Respond to App Store reviews, at the speed they arrive](https://aramb.ai/use-cases/ai-agent-to-respond-to-app-store-reviews-at-the-speed-they-arrive/): Every new review triaged, classified, and given a brand-voice draft for one-click approval, with the risky ones escalated to a human.
- [Reconcile job invoice payments, automatically](https://aramb.ai/use-cases/ai-agent-to-reconcile-job-invoice-payments-automatically/): Match deposits to open invoices on a confidence ladder, apply only what clears, and park the rest as unapplied cash with candidates.
- [Compose fractional CFO diagnostics from three statements](https://aramb.ai/use-cases/ai-agent-to-compose-fractional-cfo-diagnostics-from-three-statements/): Turn a P&L, balance sheet and cash flow into a dated, sourced nine-section diagnostic, every ratio shown with its formula.
- [Broadcast a sales leaderboard your team wants to read](https://aramb.ai/use-cases/ai-agent-to-broadcast-a-sales-leaderboard-your-team-wants-to-read/): Pull the period's numbers, show the math, and post a celebration-first leaderboard, top performers and gainers named, the bottom never shown.
- [Monitor brand reputation threats before they escalate](https://aramb.ai/use-cases/ai-agent-to-monitor-brand-reputation-threats-before-they-escalate/): Separate an organic complaint from a coordinated push, and get paged only when velocity, amplification or journalist pickup crosses the line.
- [Run a market event and filing watch desk](https://aramb.ai/use-cases/ai-agent-to-run-a-market-event-and-filing-watch-desk/): Watch your named issuers for verifiable, dated events, every figure attributed to a source, delivered as a cited, advice-free brief.
- [Track local council dockets, week over week](https://aramb.ai/use-cases/ai-agent-to-track-local-council-dockets-week-over-week/): Harvest agendas, minutes, ordinances and recorded votes, follow each item through the stage ladder, and get a neutral, cited brief.
- [Watch competitor pricing and packaging, daily](https://aramb.ai/use-cases/ai-agent-to-watch-competitor-pricing-and-packaging-daily/): Rebuild each rival's price book every morning and get a priced-impact brief only on the days something commercially real actually moved.
- [Hunt buying signals across Reddit, LinkedIn and X](https://aramb.ai/use-cases/ai-agent-to-hunt-buying-signals-across-reddit-linkedin-and-x/): Catch what buyers actually posted in the last 24 hours, graded on a pain-to-purchase ladder, with drafts ready before your outreach block.
- [Repurpose podcast episodes into eight platform-native drafts](https://aramb.ai/use-cases/ai-agent-to-repurpose-podcast-episodes-into-eight-platform-native-drafts/): Mine each transcript for standalone moments and ship a review-ready pack — LinkedIn, carousel, TikTok script, blog, email — every quote timestamped.
- [Find cash buyers from county deed records](https://aramb.ai/use-cases/ai-agent-to-find-cash-buyers-from-county-deed-records/): Isolate the deeds that closed without a mortgage, cluster the repeat buyers, and get a ranked cash-buyer list with dated deed evidence.
- [Hunt expired and withdrawn listings in your farm](https://aramb.ai/use-cases/ai-agent-to-hunt-expired-and-withdrawn-listings-in-your-farm/): Catch the listings that leave the market without selling, prove it wasn't a sale, and get a winnability-scored, fair-housing-clean call list.
- [Parse a real estate deal inbox into a clean ledger](https://aramb.ai/use-cases/ai-agent-to-parse-a-real-estate-deal-inbox-into-a-clean-ledger/): Turn a chaotic mailbox of offers, leads, loan files and permits into typed, deduped rows in your sheet, with a daily digest of what changed.
- [Track pipeline ARR movement, day over day](https://aramb.ai/use-cases/ai-agent-to-track-pipeline-arr-movement-day-over-day/): Snapshot the pipeline each weekday, diff it against yesterday, and email leadership the movers and ARR shifts with the math shown.
- [Prep daily meeting briefings like a chief of staff](https://aramb.ai/use-cases/ai-agent-to-prep-daily-meeting-briefings-like-a-chief-of-staff/): Read today's calendar, research every external attendee against cited sources, and get a per-meeting briefing pack before the day starts.
- [Track vendor API drift before it breaks you](https://aramb.ai/use-cases/ai-agent-to-track-vendor-api-drift-before-it-breaks-you/): Crawl vendor changelogs and OpenAPI specs daily, classify every change, and get a colour-coded report only when your integration is at risk.
- [Client Intake Pipeline Operator](https://aramb.ai/use-cases/ai-agent-to-run-client-intake-pipeline/): Sweeps your intake mailbox for new client documents, extracts typed fields from the PDFs and scans, validates and routes each record.
- [Dormant Lead Reactivator](https://aramb.ai/use-cases/ai-agent-to-reactivate-dormant-lead/): Sweeps your lead sheet each weekday for finance and legal prospects whose follow-up is due.
- [Funding Round Tracker](https://aramb.ai/use-cases/ai-agent-to-track-funding-round/): Sweeps venture press, aggregators and the open web for the last week's funding announcements, verifies each round against a primary source.
- [Inbound Lead Routing Officer](https://aramb.ai/use-cases/ai-agent-to-handle-inbound-lead-routing/): Classifies each new website-form lead, moves it to the right pipeline stage and owner, and sends a matching acknowledgment.
- [Investor Update Composer](https://aramb.ai/use-cases/ai-agent-to-compose-investor-update/): Closes the month from your ledger, computes net sales and growth with every figure sourced, and sends the update once you approve it.
- [LP Relationship Health Tracker](https://aramb.ai/use-cases/ai-agent-to-track-lp-relationship-health/): Watches the health of your LP, co-investor and partner relationships: reconstructs the real last interaction from the CRM, inbox and calendar.
- [Niche Signal Tracker](https://aramb.ai/use-cases/ai-agent-to-track-niche-signal/): Watches one narrow beat on a tight cadence, dedupes every find against what it has already seen, and emails only genuinely new signals.
- [Partner Intel Scout](https://aramb.ai/use-cases/ai-agent-to-scout-for-partner-intel/): Watches your strategic and ecosystem partners for funding, leadership, hiring, release and messaging moves.
- [Portfolio Signal Watch](https://aramb.ai/use-cases/ai-agent-to-watch-portfolio-signal/): Watches your portfolio companies and market themes on a cadence, diffs every public surface against a stored baseline ledger.
- [Advisor & Firm Prospect Hunter](https://aramb.ai/use-cases/ai-agent-to-hunt-advisor-and-firm-prospect/): Builds a targeted list of RIAs, advisory firms and law practices from regulator registries.
- [Biotech Catalyst Tracker](https://aramb.ai/use-cases/ai-agent-to-track-biotech-catalyst/): Sweeps FDA and EMA decisions, clinical-trial registry changes, peer-reviewed readouts and biotech deal filings against your watchlist every morning.
- [Compliance-Safe Finance Composer](https://aramb.ai/use-cases/ai-agent-to-compose-compliance-safe-finance/): Drafts a weekday finance or legal-services post that rotates topics against your 30-day post log, cites one verified public primary source.
- [Macro Markets Intel Composer](https://aramb.ai/use-cases/ai-agent-to-compose-macro-markets-intel/): Answers your standing pre-open research question across macro, central-bank, regulatory, enforcement and deal lanes: sweeps primary sources lane by lane.
- [Market & Regulatory Watchdog](https://aramb.ai/use-cases/ai-agent-to-watch-market-and-regulatory/): Sweeps your rate, index, and regulatory sources each morning, cross-validates every figure against a second dated source.
- [Market Signal Hunter](https://aramb.ai/use-cases/ai-agent-to-hunt-market-signal/): Every weekday before the open, sweeps price action, movers, headlines and the macro calendar across your coverage, reads the technical structure.
- [Protocol Watch Desk](https://aramb.ai/use-cases/ai-agent-to-run-a-desk-for-protocol-watch/): Watches the chains, protocols and tokens you name — governance votes, security disclosures, upgrades, unlock schedules.
- [Advisory Proposal Composer](https://aramb.ai/use-cases/ai-agent-to-compose-advisory-proposal/): Turns your master proposal template into a per-client Notion subpage the same day a prospect asks: scoped deliverables, a defensible price.
- [AI Cold Call BDR](https://aramb.ai/use-cases/ai-agent-to-make-cold-calls-as-a-bdr/): Runs a compliant AI-voice outbound calling desk: proves consent and scrubs DNC per number immediately before each dial.
- [Audience Reply Composer](https://aramb.ai/use-cases/ai-agent-to-compose-audience-reply/): An engagement assistant for an independent creator whose inbound has outgrown the time they have for it.
- [B2B Prospect Hunter](https://aramb.ai/use-cases/ai-agent-to-hunt-b2b-prospect/): Sweeps LinkedIn and the open web every weekday for ICP-matched B2B prospects, enriches each with role.
- [Brand Comment Manager](https://aramb.ai/use-cases/ai-agent-to-manage-brand-comment/): Sweeps every connected brand social account hourly for unanswered public comments, dedupes against a reply ledger.
- [Brand Cultural Velocity Tracker](https://aramb.ai/use-cases/ai-agent-to-track-brand-cultural-velocity/): A weekly read on where culture is moving in a brand's space, built to be actionable without being reckless.
- [Brand Pulse & Pipeline Watch](https://aramb.ai/use-cases/ai-agent-to-watch-brand-pulse-and-pipeline/): Every business morning, sweeps news, X, Reddit, LinkedIn and competitor newsrooms for brand and rival mentions.
- [Brand Voice Content Composer](https://aramb.ai/use-cases/ai-agent-to-compose-brand-voice-content/): Ask for a piece a