Skip to content

Using Vythos

Add a rule ​

Open Playbook. Every page has one box: on Everyone it adds a house rule for every client; on a client's page it adds a rule, or a fact, for that client.

Write it in one line ​

Type the rule as you'd say it to a colleague:

  • Never say "cheap" in client emails
  • Day rate is £850 for workshops
  • Northwind signs off on anything over £5,000

As you type, the line under the box says what the rule will be:

Under the boxWhat it means
Where it goesThe category Vythos suggests. Click it to choose another. When nothing in the line says where it belongs, the suggestion is shown in outline as a guess
A word in a chipA word in quotes in a never say line, which drafts will be checked for
for everyone or for NorthwindWho the rule binds: every client, or the client whose page you're on
from todayWhen it starts
Say whyOptional. The reason, up to 500 characters, so whoever reads it later knows whether it still holds
Set an end dateOptional. For a promise or anything that lapses. The rule shows Until that date, and stops being sent after it

Press Add or Enter. The rule appears under its category at version 1, and the message that confirms it has Undo.

If the line sounds like something that changes — "currently running TikTok ads", "this month's budget is £3,000" — the box asks first, because your AI tools will treat it as true until someone changes it. Rewrite it as something that holds, such as a decision with an end date, or Save anyway.

If the same rule is already there, it isn't added twice: Vythos says which category it's under.

If you paste a Google Drive or Notion link into the box, it opens Add from a document on that file, for that page's client.

A line can be up to 400 characters. One statement per line works best: two rules in one line can only be rewritten and retired together.

Add a fact about a client ​

On a client's page, the box also takes what's true about them rather than what to follow: what they sell, who to, who they compete with, what a word means to them. Northwind sells outdoor clothing to schools.

Vythos suggests whether a line reads as a fact or a rule. Where it goes then lists A fact your AI tools know (About Northwind) and the seven categories for A rule your AI tools follow; change it if the suggestion is wrong. Add a fact, under About Northwind, points the box there directly.

  • Facts appear under About {client} at the top of their page, one line each, rewritten or removed in place.
  • Your AI tools receive them as context about the client, never as rules to follow.
  • A fact has no reason or end date. Something that lapses is a rule with an end date instead.
  • An amount of money can't be a fact. Prices and terms belong in Pricing & rates or Terms & commitments, where access to them is set. The box says so and offers Make it a rule.
  • A client can have up to 25 facts.

Facts are per client. Your agency's own description — what you do, who for — lives in Settings.

Add from a document ​

To make an existing document a rule, use the document button in the box (Add rules from a document), or Add from a document on an empty page. There are two ways to name a document, and the rest of the card is the same either way.

Copy the document's URL from your browser's address bar or its Share button, and paste it in. Vythos understands:

LinkExample
Google Dochttps://docs.google.com/document/d/…/edit
Google Sheethttps://docs.google.com/spreadsheets/d/…/edit#gid=0
Google Slideshttps://docs.google.com/presentation/d/…/edit
A file in Drivehttps://drive.google.com/file/d/…/view
Notion pagehttps://www.notion.so/Rate-Card-2026-1a2b3c… or a notion.site link

You'll need the relevant source connected first, because Vythos reads the document with your access. A link to a folder is refused, with a note telling you to open the file inside it.

Choose from your sources ​

Browse instead of pasting:

  • Google Drive — My Drive and Shared with me, with folders, breadcrumbs and a search box that looks up files by name. Files already in your Playbook are marked, and files in formats Vythos can't read are shown greyed with the reason.
  • Notion — your pages, searchable.
  • Local files — everything you've uploaded, from the Sources page or during setup.

Very large folders are listed up to a limit and say so; use search rather than scrolling.

The card ​

Once a document is chosen, Vythos reads it and shows one card.

What it governs — the category. Only the categories you're allowed to add rules to are offered.

Which client is it for? — All clients — agency-wide for a house rule, or one client. You can add a new client here without leaving the card. This field is about whose work the rule governs; it has nothing to do with who may see it. See Clients and scope.

The values Vythos read — any figures it recognised. Tick These values are right only if they are, and only if they mean what their labels say. See Values.

Replaces — appears when something else is already in force that this document might supersede:

  • Also a pricing rule for every client — both can stay in force. Tick the ones this replaces, if this is the newer version.
  • Already a rule with the same name, from another file — you must decide. Vythos won't let a same-named document quietly take over from another file.

Read the document — the exact text Vythos took from the file. Worth opening the first time you add a document of a given kind, particularly a PDF or a spreadsheet, to check that what matters came through.

Then Add to Playbook. The rule appears at version 1.

Who can add rules ​

The workspace owner; anyone with Can edit for the rule's category; and, for a client's own rules, whoever looks after that client (except Pricing & rates and Terms & commitments). Everyone else sees the Playbook without the box. A teammate can still put a rule forward: their AI tool can save it, and it waits for you under Waiting for you. See Save from your AI tools and Your team and their access.

When something goes wrong ​

What you seeWhat it means
That rule is already there, under …The same line is already a rule on this page
That's a folder. Open the file inside it and copy that link.You pasted a folder link
Vythos reads links to Google Drive files and Notion pages.The link isn't one Vythos recognises — check you copied the whole URL
Google Drive isn't connected. Connect it in Sources first.Connect the source, then try again
Vythos can't open that file with your Google account.The file isn't shared with the account you connected
'…' is in the bin in Google Drive.Restore it, or pick another file
Vythos does not read Google … / a format refusalSee File formats
'…' is empty.There's no text to read — a scanned PDF, or an empty document
This document is already a rule.The same file is already in your Playbook. To move it to another category, add it again and choose the new one
The document has changed since you checked its values — look againSomeone edited the file while the card was open. Reopen it so you confirm what it says now

After adding ​

  • The rule appears on the Playbook under its category.
  • Your team and their AI tools get it immediately, within the limits of their access.
  • A document rule is followed from then on — about every ten minutes. A one-line rule changes only when you rewrite it. See Update a rule.

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