Skip to content

Using Vythos

Clients ​

A client in Vythos is a name that rules and facts can be attached to. Adding one costs nothing and gives the client a page of their own in the Playbook.

Add a client ​

On the Playbook, choose + beside Clients in the rail on the left, type the name and press Enter. You can also add one from inside the Add from a document card when you're filing a document for them.

Nothing else is needed. There's no import, no matching, no setup — and Vythos never invents a client from a document it read.

Give them their own rules ​

Open their page and write the rule in the box: Never use emojis in Northwind copy. A new client's page starts you off with three questions — What do we say no to?, Who signs off? and What have we promised? — and each answer becomes a rule.

For a document — their brand guidelines, their signed terms — use Add from a document in the box, which files it for that client. See Add a rule.

From then on, for work that names that client:

  • Their rule replaces your house rule in that category.
  • Everywhere they have no rule of their own, your house rules apply.
  • AI tools are told which rules are the client's, so a tool can say "I'm using Acme's payment terms, not your standard ones".

Their page shows their own rules and, folded in and marked Everyone, the house rules that apply to them — so it answers "what does the AI know about this client?" in one place. A switch hides everyone's rules.

See Clients and scope for how the ranking works.

Tell your AI tools about them ​

Under About {client} at the top of their page, add what's true about them: what they sell, who to, who they compete with. Northwind sells outdoor clothing to schools. Add a fact points the box there, or type it in the box and Vythos suggests it's a fact. Your AI tools get these as context for that client's work, not as rules.

Say which emails are theirs ​

A file can sit in a client's folder. An email, a meeting or a call has no folder, so Vythos goes by who it's with. Under Their email domains, at the bottom of About {client}, add the part of their email addresses after the @: northwind.com. You can paste a whole address or their website and Vythos keeps the domain.

From then on, emails, meetings and call recordings with people at that domain are filed under the client, including the ones already synced. Something with two clients' people on it is filed under neither.

A few things can't be a client's domain:

  • an address anyone can have, like gmail.com
  • your own domain, because it's on every email you send
  • a domain another client already has

Owners and leads can change a client's domains.

What else files something under a client ​

Vythos files a synced item under a client only when something says whose it is, and matches it to a client you've added. It never adds a client itself.

  • A folder with their name: Clients/Northwind/brief.pdf, or a Drive folder called Northwind that you chose to sync.
  • A line near the top of a document: Client: Northwind.
  • A Slack channel with their name: #northwind or #client-northwind. An owner or lead can also pick the client for a channel in Sources.
  • Their email domain, as above.

A mention isn't enough: a note that says "as we agreed with Northwind" stays unfiled. So does anything two clients have a claim to.

A question about Northwind, in Ask or from an AI tool, then reads what's filed under Northwind and what's filed under nobody. It never reads what's filed under another client. If something seems to be missing, ask again without naming the client.

See what the AI did for them ​

A client's page has two tabs: Rules, and AI activity, which shows what the AI did for them over the last 90 days. Each job is one time an AI tool, such as Claude through the Vythos connector, was given their rules. An orange dot on the tab means a draft check found something to look at.

At the top are four numbers: AI jobs, drafts checked, jobs that need a look, and things saved. Click Needs a look or Not checked to see only those jobs. Jobs are listed under their day, newest first. For each job you see:

  • what you asked, if it was your job, or "A colleague's AI job" (nobody is named, and a colleague's request stays private);
  • the time, and which rules it was given (open the job to see them);
  • what the draft check found: rules broken, figures that weren't in what the AI was given, and other clients' names. If the draft was never checked, it says so.

Under the jobs is what was saved for the client, rules and facts alike.

Download gives you the same record as a file you can share with the client, to show which rules the AI followed for them. It never includes what anyone asked their AI tool. Check it before you send it.

Only owners, leads who work on the client and whoever looks after the client see the AI activity tab, and only the rules they're allowed to read. What a colleague asked their AI tool stays theirs, and questions in Ask never appear here.

Naming them the way your team writes ​

Use the name people actually type: Acme, not Acme Holdings (EMEA) Ltd. Vythos matches the client out of a question or a task description, so the name that matches most often is the one worth using.

If two clients have names close enough to confuse, Vythos uses neither rather than picking one. Rename one of them to something distinct.

Limiting who sees a client ​

When you invite someone you can assign them clients:

  • Assign none — they can see every client's rules, within their category access.
  • Assign one or more — only those clients' rules reach them, in Ask and in their own AI tools.

Useful for freelancers on a single account. See Your team and their access.

When an engagement ends ​

Retire that client's rules from their rows on the Playbook. The client name stays — their past decisions are still part of your record — but their terms stop overriding your defaults for anything that mentions them.

If the client comes back, write their rules again, or add their documents again — a document rule resumes with its history intact.

Vythos — the context layer for agencies that run on their own rules.