Cuiar
Sign inDownload

Hermes Agent + Cuiar

Show Hermes a chore once. It keeps the skill.

  • ~/.hermes/config.yaml
  • OAuth, also by device code
  • Cron to Telegram or Discord
Set it up Get Cuiar

Hermes writes its own skills. The first time, it does a chore step by step with Cuiar: sign in, open the page, click.

Then it saves the steps as a skill and runs them on its cron. When a run fails, it adds a step. Your passwords stay in the Cuiar vault, outside the skill file.

Hermes calls four Cuiar tools one after the other: sign in, open the booking page, pick a room, confirm. The four steps then fold into a skill card named coworking-room, which gets a weekly schedule.

Setup

Add Cuiar to config.yaml.

Hermes runs on your computer or on a server. On a server, it reaches the Cuiar app on your computer through the remote MCP server.

  1. 1

    Install Hermes

    Skip this when Hermes is installed.

    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
  2. 2

    Add the server

    Or run hermes mcp add cuiar --url https://mcp.cuiar.com/mcp --auth oauth.

    ~/.hermes/config.yaml
    mcp_servers:
  cuiar:
    url: "https://mcp.cuiar.com/mcp"
    auth: oauth
  3. 3

    Sign in

    On a server with no browser, add --flow device. In a running chat, /reload-mcp loads the server.

    hermes mcp login cuiar
hermes mcp test cuiar
  4. 4

    Teach it a chore

    Book a meeting room in my coworking portal for next Tuesday from 10:00 to 11:00, and save the steps as a skill.

Other ways to connect

  • An API key

    Use a key with the mcp scope.

    ~/.hermes/config.yaml
    mcp_servers:
  cuiar:
    url: "https://mcp.cuiar.com/mcp"
    headers:
      Authorization: "Bearer ${CUIAR_API_KEY}"

  • Local stdio

    When Hermes runs on the computer with the Cuiar app.

    ~/.hermes/config.yaml
    mcp_servers:
  cuiar:
    command: "cuiar"
    args: ["mcp"]

Route

Single steps make good skills.

Hermes learns from its tool calls. MCP gives it single steps to record, such as sign_in, navigate and click. A finished skill can also give the whole task to the Cuiar agent with the CLI.

Remote MCPmcp.cuiar.com/mcp
Best fit
OAuth with PKCE, or device code on a server.
Local MCPcuiar mcp
Works
On the computer with the Cuiar app.
CLIcuiar exec
Works
With the local terminal backend. Other backends need cuiar installed there and CUIAR_API_KEY set.
Routineson a schedule
Works
Hermes cron for jobs that need its memory and chat. A Cuiar routine for browser-only checks with an email result.

Example tasks

Chores Hermes can learn

  • 01

    Book a room each week

    “Book a meeting room in my coworking portal for next Tuesday from 10:00 to 11:00, and save the steps as a skill.”

    Hermes writes ~/.hermes/skills/coworking-room/SKILL.md.

  • 02

    Watch a forum

    “Every 6 hours, open my Community workspace, check five saved threads on the members-only forum and send new replies with links to Telegram.”

    A Hermes cron job.

  • 03

    Build a dataset

    cuiar exec --json --folder ~/datasets/lab "Collect name, price and stock for each item in the Lab supplies category of my distributor account into a CSV."

    Hermes checks the row count and fills gaps on the next run.

  • 04

    Post a weekly digest

    cuiar --odyssey --permission read-only "What changed last week in EU battery rules? Use my paid trade-journal login."

    Every Monday at 07:00. Hermes posts five points to Discord. Odyssey is on Pro and Team.

  • 05

    Get into a full class

    “At 07:00, when booking opens, sign in to the gym portal and book the Thursday spin class. If it is full, join the waiting list.”

    Hermes added the waiting-list step after a failed run.

Good to know

Unattended runs
In cron, Hermes refuses dangerous commands. Keep scheduled Cuiar work read-only with --permission read-only, or move it to a Cuiar routine.
Skill review
skills.write_approval holds new skill files until you approve them.

Templates to run from Hermes Agent

All templates

Each template page shows the run_task or create_routine call to give Hermes Agent.

  • Monitoring

    Track mentions of your brand

    New posts about your brand, with their tone. Questions and problems first.

    On a schedule: Every 4 hours
    • X
    • Reddit
    • Hacker News
    • +1 more: LinkedIn

  • Monitoring

    Track new rules from regulators in my field

    New and proposed rules on your topics each week, with what changes, who it affects and the deadlines.

    On a schedule: Every Monday at 8:00
    • Any government site
    • Google Docs

  • Monitoring

    Watch vendor changelogs for breaking changes

    New changes and deprecations in the APIs and tools you depend on, with the dates and the work they need.

    On a schedule: Every Monday at 8:00
    • Any website
    • GitHub

  • Monitoring

    Get new research papers on my topic each week

    New papers and preprints on your topic, the most relevant first, with a plain summary of each.

    On a schedule: Every Friday at 8:00
    • arXiv
    • PubMed
    • Semantic Scholar

  • Monitoring

    Track new G2 reviews of my competitors

    What customers praise and dislike in your competitors' new reviews, grouped by theme each week.

    On a schedule: Every Monday at 10:00
    • G2
    • Capterra
    • Google Sheets

  • Monitoring

    Check that my key pages stay in Google's index

    A weekly check of your most important URLs, with an alert when one drops out of the index.

    On a schedule: Every Thursday at 8:00
    • Google Search Console
    • Google Sheets

More agents

All AI agents

Start on the Free plan.

The MCP server, the vault and unlimited routines are free. Steps that your own agent takes use no Cuiar credits.

Get CuiarDeveloper docs