---
title: Hub Descriptions
---

# Hub Descriptions

## What it is

Omniscio is made of a lot of parts. There are the **built-in tools** (Skills, Recipes,
Gmail, AI Council, Mission Control, and dozens more), the **sidebar categories** that
group them (AI Tools, Productivity, Communication, …), and **your own projects**. Each
one of those is a "hub".

**Hub Descriptions gives every hub a short, plain-English line saying what it is and when
it matters** — and lets you rewrite any of those lines yourself.

The point is not decoration. Those lines are what your **Chief of Staff** and any agent
you ask actually read. Without them an agent knows a hub called "Coffer" exists but has
no idea what it does, so it can't sensibly point you at it. With them, it does.

## Where to find it

### Where the descriptions come from

Every built-in tool and every sidebar category ships with a **default description already
written** — you don't have to fill anything in for this to work.

Your own projects start blank, because only you know what they are. You can write a line
yourself, or press a button and have AI draft one from the project's folder and README.

Whatever you write always wins over the built-in default.

### Editing them

**Settings → Tools & Maintenance → Hub Descriptions.**

The page lists every hub grouped into **Tools & integrations**, **Categories**, and **Your
projects**, with a filter box at the top so you can find one quickly. Each hub has:

- an editable text box (up to 240 characters, with a live counter),
- **Regenerate with AI** — writes a fresh description for that one hub. It only fills the
  box; nothing is saved until you press **Save**, so you always see it before it counts.
- **Reset to default** (a built-in tool or category) or **Clear** (one of your projects) —
  only shown when you've actually customised that hub.

A small label on each row tells you whether the current text is the built-in **Default** or
your own **Custom** line.

There is deliberately no "regenerate everything" button — each line is generated one at a
time, on purpose, so a stray click can't spend money across a hundred hubs.

## How it behaves

### Who reads the descriptions

Two places, both pull-only — this never gets forced into every session's prompt:

- **Your Chief of Staff** gets the list of switched-on hubs (with descriptions) each time
  it starts, so it knows what your Omniscio actually contains.
- **Any agent that asks** can read them from `GET /hubs`, which returns every built-in tool
  and category with its description and whether it's currently turned on. Your projects are
  deliberately left out of that list — they go to your Chief of Staff, not to any agent that
  happens to ask.

### Cost

Writing and editing descriptions is free. Only **Regenerate with AI** spends anything: it's
a single short call to a cheap model (Haiku), capped by a daily spending limit and a
rate limit, and it only ever runs when you click the button.

### Turning it off

It's **on by default**. If you don't want the editor, Settings → Lab → *Hub Descriptions*
turns the section off with one flip. The descriptions themselves keep working for your
Chief of Staff and agents either way — the toggle only hides the editing screen.

## Related

- Contract (engineering rules): `.claude/memory/contracts/hub-descriptions-contract.md`
- The Chief of Staff: [simple-mode.md](simple-mode.md)