Sign in, find your way around, and understand organisations, spaces, folders and notes
Kribble is a knowledge base: you write notes, group them in folders and spaces, and share them with the people you work with. This page covers signing in, the layout of the app, and how your notes are organised.
Open your Kribble server's address in a browser. Your administrator gives you this address.
On the sign-in page, enter your Username (your email address works too) and Password, then click Sign in.
If your server lets people register, there is a Sign up tab. Fill in your email address, a username, a display name and a password, then click Sign up. If the server sends email, you'll see Check your email: click the link in the message to finish creating your account.
If there is no Sign up tab, the server is invite-only. Ask someone in your organisation to invite you. The invitation email has a link that opens an Organization invite page, where you can create your account and join in one step with Accept invite & create account. If you already have an account, sign in and click Accept invite.
If your administrator connected Kribble to your company directory (LDAP or Active Directory), sign in on the same form with your directory username and password. The first time you do, Kribble creates your account for you. Depending on how the server is set up, you may also be added to organisations and teams automatically.
Click Forgot password? under the password field and enter your email address. Kribble emails you a link to set a new password. This only works if your server is set up to send email; otherwise ask your administrator.
The kribble CLI and the desktop app don't ask for your password. When you run kribble login (or connect a server in the desktop app), a page opens in your browser asking Sign in the kribble CLI?.
Only continue if you just started the sign-in yourself and the code on the page matches the one in your terminal.
Under Organization, pick All my organizations (including ones you join later) or Only one of them. Under Access, pick Read and write notes if you'll use it with an AI agent that edits notes, or Read notes only.
Click Approve. The page says You're signed in and you can go back to your terminal. Click Deny if you didn't start this.
Approving creates an access token. You can revoke it later on the Access Tokens tab of the organisation's settings (for All my organizations, your personal vault's settings).
The app has three parts.
The sidebar on the left holds the search box, the list of spaces with their folders and notes, a CLI & agents link for setting up the command line and AI agents, and at the bottom the organisation switcher.
The top bar has the Toggle sidebar button (it hides and shows the sidebar), the breadcrumb showing where the open page sits, and on the right the note's actions when a note is open, the notification bell, and your avatar. On narrow screens the sidebar slides in over the page. On a phone the top bar shows the open page's name with its folder above it, and keeps only Edit (or Save while editing) beside a ⋯ menu that holds Comments, Version history, Export as PDF and Copy as.
The main area shows the page you opened: the home page, a space or folder overview, or a note.
When you switch to an organisation, you land on its home page. It shows:
the organisation's name and how many spaces and notes it has
Recently updated: the eight notes changed most recently, with where they are and when they changed
Spaces: a card for each space you can see, with its description and how many notes and folders it holds. Click a card to open the space. New space creates one.
To come back to the home page, pick the organisation again in the switcher.
Everything in Kribble lives in an organisation.
Your personal vault is an organisation that only you own. Everyone gets one, with a first space called "My Notes". It's private until you share a space from it.
Team organisations are shared with other people. Each member sees the spaces they've been given access to.
The organisation switcher at the bottom of the sidebar lists your organisations in groups: Personal, Organizations, and Shared workspaces (personal spaces other people have shared with you). Click one to switch to it. Hover an organisation and click the gear icon to open its settings.
Click the organisation switcher at the bottom of the sidebar and choose Create organization.
Enter a Name (URL slug), the short name used in addresses (for example acme-corp), and a Display name that people see (for example "Acme Corp"). A Description is optional. Choose the URL name with care: it can't be changed later.
Click Create organization. You are its owner. To bring people in, see Sharing and permissions.
Inside an organisation, your writing is arranged in three levels:
Spaces are the top-level areas, such as "Engineering" or "Handbook". In a team organisation, each space has its own list of members, so a space is the unit of access.
Folders group notes inside a space. Folders can contain other folders.
Notes are the documents you write.
To create a space, click the + next to Spaces in the sidebar (Create space), or New space on the home page, type a name and press Enter. In a team organisation you need permission to create spaces.
To create a note or folder, right-click a space or folder in the sidebar (on a touch screen, press and hold it) and choose New note or New folder. Type a name and press Enter, or press Esc to cancel. You can also open a folder and use the New note and New folder buttons on its page. Organising notes covers renaming, moving and deleting.
Click a note in the sidebar to open it. Click a space or folder to open its overview, which lists its Contents and the notes in it that changed recently.
A note opens for reading. Above the title, a line shows its revision number, who saved it last and when, and how long it is. On wide screens, an outline of the note's headings sits to the right of the text; click a heading to jump to it. To change the note, click Edit in the top bar (see Writing notes).
To open a note in a new tab, Ctrl-click (⌘-click on a Mac) or middle-click it in the sidebar, or right-click it and choose Open in new tab. In a browser this opens a browser tab. The desktop app has its own tabs and can show notes side by side: see The desktop app.
Each note has its own address in the browser's address bar. Copy it to send a colleague straight to the note; they need access to its space to open it.
Click your avatar in the top-right corner and choose Light mode or Dark mode. Kribble starts in dark mode and remembers your choice in this browser.
Click your avatar and choose Profile & Preferences to change your display name and avatar, change your password, or set the text size notes are shown in (under Editor). You can also change your avatar by clicking it at the top of the avatar menu.
These work anywhere in the app. On a Mac, use ⌘ where it says Ctrl.
Shortcut | What it does |
|---|---|
Ctrl+K | Open search |
Ctrl+E | Move the keyboard focus to the sidebar |
Ctrl+S | Save the note you're editing |
Ctrl+Alt+M | Comment on the selected text |
The editor and the sidebar have more: see Writing notes and Organising notes.