The guide
Everything Animus can do
Tasks, time and invoicing per client, and notes for what you learn. The desktop app is for the work, the phone for capturing. A lot of it is one short form away, so start with these three.
tomorrow 9:00 #shop/ [[ ::Quick reference
The short forms that save the most typing. Each is explained further down.
Opens the palette. Typing searches everything; written in quick-add syntax, it offers the task.
Adds what you typed as a task, from any row.
call jamieStarts a call note with that contact (`anruf` in German).
SHOP-142 142Finds a ticket's task by its key, or by its number alone.
Back and forward through the pages you visited; so do the mouse's side buttons.
Adds a task.
Goes to the sidebar's pages: Today, Inbox, Tasks, Notes, Time, Reports.
Stops the running timer, or opens the form to start one.
Selects the next or previous task, ticks it off, opens it.
Edits it; so does a double-click.
Finishes writing, like Done. An open menu takes Esc first.
Lists every key.
#projectFiles the task under that project and its client.
@clientFiles the task under that client.
tomorrow fri 13.10.Sets the due date.
tomorrow 9:00Sets the due date and a reminder at that time.
every friday every month on the 1st every 3 daysMakes the task repeat; the next one appears when you tick it off.
every! 3 daysRepeats counted from the day you finish it.
Links the contact and brings their client along.
/Opens the menu of line types and things to insert.
[[Links a note, a journal day, a call or a task.
question :: answerBecomes a review card, asked on Today.
/doneAdds the tasks you finished that day, by project.
/tidyStructures a quickly typed note.
2 1:30 90m2 hours, 1 hour 30 minutes, 90 minutes.
Starts the timer some minutes ago, or at a time.
Show the answer, forgot, got it.
Collapses the sidebar to a rail of icons.
Tasks
Capture first, sort later. A task needs only a title; everything else can be said in the same line.
Search and the command palette
Desktop: CtrlK, the search box in the middle of the window bar, or >_
on the rail.
One box to search everything, run a command or add a task, without the mouse.
-
Type and it searches: the matching commands first, then open Tasks (by title or ticket key:
SHOP-142, or just142), Notes, Calls, the Journal, Done tasks, Pull requests, Projects, Contacts and Clients. - Five per group, then Show all N. For notes, calls, the journal and done tasks it opens their page with the search filled in; the other groups open up in place.
- Enter opens a result as a click on its own page would: a task in the task panel, a note, call or journal day as a page, a pull request in the browser, a project or client on its page, a contact on its client's.
- Empty, it shows Add task first, then Recent: the last five things you opened from it. Then the commands.
- ↑ ↓ to pick, Enter to run, Esc to close.
Adding and running from the palette
-
Write a task in quick-add syntax,
fix login #shop tomorrow, and the first row is New task with its chips. Enter adds it. - Otherwise Add as task: … is the last row, and CtrlEnter adds what you typed as a task from any row, in quick-add syntax.
-
calland a contact's name,call jamie, offers Start a call note with Jamie Reyes, with their client and project. In German,Anrufworks too. - Add task, New note and Start timer on… (Stop timer while one runs) from wherever you are. Go to any page, or type a client's name to open it.
- The pomodoro: Start a focus round; while one is on, Pause the pomodoro or Resume the pomodoro, Skip this pomodoro phase and Reset the pomodoro.
- Resume … for each piece of recent work on Today, and Review 3 due questions while questions are due.
- Write today's journal, Log time…, and Timesheet PDF…, which opens Time's list on last month, the month you invoice.
- Bill a client… lists your clients; pick one for its billing dialog. Esc, or Backspace in the empty field, goes back.
- Hide amounts / Show amounts, and Switch to the light theme / Switch to the dark theme.
- Commands with keys of their own show them: Q adds a task, Ctrl1 … 6 go to the sidebar's pages, ? lists every key.
Quick add
Desktop: Add task on Tasks, Q, or typed straight into CtrlK. Phone: the field on top of Today.
Write the task as a sentence. What Animus recognises is highlighted while you type and becomes a chip.
-
#and@suggest your projects, clients and contacts. Names may contain spaces. - A project brings its client, so
#shopis enough. - A contact is recognised by full name, or by first name when only one contact has it: "Call Jamie friday".
- Recognised by mistake? Remove the chip and it is plain text again.
Dates and reminders it understands
today,tomorrow,day after tomorrow.-
mon…sun,friday,on friday: the next such weekday. next week: next Monday.in 3 days,in 2 weeks.13.10.or13.10.2027; without a year, the next time it comes round.-
A time after the date sets a reminder:
tomorrow 9:00,fri 14,mon 850,tomorrow noon. 24-hour;noon,midnight,morning(9:00) andevening(18:00) work too. -
German works the same:
heute,morgen,übermorgen,freitag,nächste woche,in 3 tagen,mittag. - In a task's detail, the Reminder row takes the same words, or a calendar and a clock. A reminder needs no due date.
- At that moment your phone gets a push and the open desktop app a system notification.
Today, Inbox and Up next
Today is the page the app opens on.
- Up next: line up what to work on with the list button on a task; a long press drags them into your order. Start times the first one.
- Under the title one line sums up the day: what is overdue and due, the hours tracked today and the money left to invoice (hidden with the eye, like every amount).
- Today's tasks: overdue, due and done. An overdue task says for how long. Once nothing is left open, it says the day is cleared.
- Inbox: a task without client, project or date waits here until you give it one.
- Tasks: everything open, grouped by client and by where it comes from, or as one plain list.
- On the desktop the keyboard walks a list: J / K select the next or previous task, X ticks it off (with undo), Enter opens it.
- ▶ on any task starts the timer for it, with its client and project.
- A task lists Mentioned in: the notes, journal days and calls that link to it.
- Today shows what it showed last at once and loads behind it. Offline it keeps what it has and says so.
Subtasks
In a task's detail, under its notes.
Split a task into steps.
-
Type a step into Add subtask and press Enter; the field stays, so the next step follows at once. A date and time in it (
tomorrow 9:00) set the due date and reminder, as in quick add. - A subtask is a task like any other: tick it off, give it a due date or a reminder, put it in Up next, start the timer on it, link it from a note.
- It belongs to its parent's client and project and moves with them. One level only: a subtask has no subtasks.
- The lists show the parent with its progress, 2/5; a subtask shows up on Today when it is due, with its parent's name.
- Ticking off the last subtask leaves the parent open: you decide when the whole is done. Deleting the parent deletes its subtasks.
Repeating tasks
In a task's detail, the Repeats row; or say it in quick add.
Tick one off and the next appears with its next date. The one you did stays done, so the journal, Reports and the time on it are kept.
- The Repeats row offers never, every day, every weekday, every week on the days you pick, every month on a day or the last day, every year, or your own: every N days, weeks, months or years. It shows the next three dates.
- Count from when I finish it counts the next date from the day you tick it off instead of from the schedule.
-
Say it in quick add:
every day,every weekday,every friday,every mon and thu,every 2 weeks,every month on the 15th,every last day,every year,every 3 days.every! 3 dayscounts from when you finish it. -
German works the same:
jeden Tag,jeden Werktag,jeden Montag,alle 2 Wochen,jeden Monat am 15.,alle! 3 Tage. - A repeating task always has a due date: set a repeat on one without and it gets the first date on or after today. Remove the date and it stops repeating.
- Reopened a finished one by mistake? The next one goes away again, as long as you have not touched it.
- Repeats: never, or deleting the open one, ends the series.
- Tickets and subtasks don't repeat. A repeating task brings its subtasks along.
Done tasks
Tasks, the Done switch at the top.
Everything you have finished, the latest first.
- Grouped by the day you finished it: Today, Yesterday, then the date.
-
Search by title or ticket key (
SHOP-142), and narrow it to a client or a project; a project brings its client along. - Subtasks, every occurrence of a repeating task, and tickets closed in Jira or ClickUp are all here.
- Tap one to open it. Untick it to reopen it, with an undo.
- It loads more as you scroll, until it says Nothing more.
Time
A timer for now, entries for what you forgot, and a week you can draw on.
The timer
Start it from a task, a recent entry, a pull request, or on its own.
- Forgot to start it? Right-click (phone: long-press) any ▶ to start it 5, 10, 15 or 30 minutes ago, or at a time.
- Click the running entry to change its start, task, client, project, service or description.
- Forgot to stop it? After eight hours it turns to a warning, and Today offers Stop or "Fix the end time". It never stops by itself.
- Stopped by mistake? The toast has Resume: the timer comes back with its original start. A run under a minute is not saved, and Resume brings that one back too.
- The recent work on Today resumes what you did before with one click.
- Desktop: CtrlShiftSpace stops the running timer, or opens the form to start one.
The week on Today
- Your hours per day in your projects' colours.
- Last week's days stand behind the bars as outlines, with a dashed line at 8 hours.
- ‹ › turn to earlier weeks.
- Hover a project to see its hours and highlight it in the bars.
The week view
Desktop: Time opens on it. The phone shows the list (under More).
- Click free space to add time from that quarter hour.
- Drag over free space to add exactly that range.
- Right-click free space to start the timer from there, or to add time from there until now.
- Drag the bottom edge of an entry to move its end.
- Hover a short entry to see all of it.
Entries, the list and the timesheet
-
An entry is a duration with an optional start, or from–to. The duration takes
2,1:30or90m. -
Dates can be typed (
13.10) or picked; Today and Yesterday are one click. Time can be booked ahead. - The list shows a period by client, project and day. Days start folded, so a busy week reads as hours per day.
- ▶ on an entry continues that work.
- Timesheet as PDF: a client's or project's menu in the list saves its hours for the period shown, to send with the invoice. You see the pages first.
- "Show rates and amounts" decides whether the client sees money or hours only.
Billing and goals
Invoices go out at the start of a month for the month before. "To invoice" is what is still unbilled from earlier months.
Billing a project
Today → To invoice → a row. Or "Bill…" in a project's menu in the time list.
-
Bill everything, up to the goal or limit, or a custom
number of hours (
53or53:30). - The rest is carried to the next invoice, where it counts toward that month's goal, or given away as goodwill: still tracked, never billed.
- Undo in the toast, or in the ⋮ menu of the latest billing run on the project's page, puts everything back.
The month, goals and rates
- This month on Today: hours and money so far. The eye hides all amounts on this device; on the desktop it sits in the window bar.
- Monthly goal: billable hours to reach each month per project, with the time carried in and the goodwill.
- Hour cap: a limit from one day to another, e.g. 20 h from 1 to 20 October.
- Rates: a client has a default hourly rate, a project can have its own, and a rate period applies from one day to another.
- Lump sum: a rate period can be a fixed fee per month. Hours stay tracked, and each finished month is listed under To invoice.
Reports
Desktop: Reports in the sidebar, after Time. Phone: under More.
Today is for what to do now. Reports looks back: how the week, month or year went. It only shows; nothing on it changes your data.
- Period: this or last week, month or year, or a range of your own. The arrows step back and forward by the length of the period, and Today brings you back. The preset is remembered on this device.
- Comparison: each figure shows its change against the period before, like "+12 %". "—" means there was no time then.
- Tap a client or project in the breakdown to narrow the whole page to it. The chip at the top clears it.
- Hours over time: a bar per day, per week for longer periods, per month for a year. Each bar is split by project colour.
- Breakdown by client, project or service, and by task: where the time went, largest first.
- Done in this period: the tasks you finished, by day, with the time tracked on each. Tap one to open it.
- Hours per working day counts Monday to Friday, up to today while the period runs. With public holidays chosen in Settings → Working days, those count as days off.
- Goals show when the period is one month, as on Today.
- The eye hides amounts here too (on the desktop, the one in the window bar). Hours stay.
Notes
Markdown that formats itself while you write. No Save button: changes save on their own, and a quiet Saved beside the back arrow says so. On the desktop E or a double-click edits the note you are reading (the cursor lands where you clicked), and Esc or CtrlEnter finishes, like Done.
The / menu
Type / at the start of a line, then a few letters to filter.
- Line types: text, headings, bullet and numbered lists, to-dos, quotes, a divider.
- Things to insert: a question, a photo from your files, or a new one from the camera, e.g. of a slide.
- The English names work in German too:
/todo,/quote,/done. - In a list, Enter continues it and Enter on an empty item ends it. Tab indents.
- Tables written in markdown show as tables.
Links with [[
- Type
[[and pick a note, a journal day or a call. While reading, the link opens it. - A link to a title that does not exist yet creates that note when you tap it.
- Below the notes come your tasks: open ones, then the last 200 done ones. A linked task shows a box that ticks itself once the task is done.
- Every note lists Linked from. Renaming a note updates the links to it.
Review cards
For what you want to remember. A line with :: between question and answer becomes a card.
- Today asks the cards that are due.
- Got it grows the gap until it is asked again: 2, 5, 13 … days. Forgot brings it back tomorrow.
- With the keyboard: Space shows the answer, 1 is forgot, 2 is got it.
- While reading a note, a question shows as a card with its next due date.
- Works in calls and on handwritten pages too.
The journal and /done
One entry per day, written like a note. Today shows today's; a tap opens it ready to type.
-
/doneadds the tasks you finished that day, by project, as ticked to-dos linked to them. - Run it again later and only the new ones are added.
- An open to-do in a journal day has a + Task chip that makes it a real task.
- Past days are in the Journal tab next to Notes and Calls.
- On a working day's evening, while the day is still empty, a journal nudge asks for it with the day's done tasks and hours; a tap opens it.
Tags, search and Tidy
- The tag field suggests the tags you already use, even through a typo. Tap a tag above the list to filter by it.
- Search looks in titles, text and tags, shows where it found the match, and reads handwriting too.
- A note can belong to a client and a project; it then shows on their pages.
-
Tidy (✨ or
/tidy) structures a quickly typed note into headings, lists and to-dos, with nothing added or left out. First you can tell the AI what to keep in mind (keep it in English,fewer headings); then you see before and after, and Back takes you to what you typed, to change it and tidy again. It needs your own Claude, OpenAI or Gemini API key. - Rules for Tidy: what you always want for notes, calls or the journal goes in Settings → Tidy, typed or picked from the suggestions. They go along with every tidy of that kind; Always do this for calls in the tidy dialog turns what you typed into one.
- Discard changes in the ⋮ menu puts a note back as it was before you started writing, even after a restart.
- Share (phone) sends a note as text to another app; Copy as markdown copies it.
- Changed on another device while you write? Animus says so and lets you pick "Load theirs" or "Keep mine".
- Pin a note to keep it on top.
Handwritten pages
Turn it on in Settings → Notes. Best with a tablet and a stylus.
- Pen, highlighter, eraser, shapes, photos to write over, and typed text boxes, on blank, lined, squared or dotted paper.
- Handwriting to text (Android): a moment after you stop, each block gets an Aa chip that converts it where it stands, in English or German.
- Scratch out: one straight stroke through writing deletes it.
- Fix a word that was read wrong: tap it for other readings, or write it again.
- Keep a tool with its colour and width as a ready pen.
- Converted text is the note's text: search,
[[links]]and review cards work on pages. - ⋮ → Share as PDF cuts the page into A4 sheets without cutting through a word.
Calls
A log of calls and meetings, typed while you talk.
- Start one from a client or project page, a contact's menu, or the Calls tab. It opens ready to type.
- A bar on every screen shows the running call, so you can look something up meanwhile.
- Add the client, project and who was on it during or after the call.
- Log as time turns an ended call into a time entry. It does not count as time unless you do.
-
Everything from notes works: the
/menu, photos, to-dos with + Task, review cards, Tidy.
Clients, tools and devices
Clients and projects
- Add client walks you through it in one go: the client, its projects, its contacts and its tools.
- Each has a label colour. A task's chip shows the project in its colour with a dot in its client's.
- A client's page starts with its month: hours, money and its projects' goals. ‹ › turn to earlier months, which say whether they are billed.
- Client and project pages have Notes and Calls tabs and list their contacts.
- Master data holds your services, your company details and the integrations.
- Your company details copy one at a time, or as a subset: Copy subset lets you tick what someone needs for an invoice (say name, address, VAT ID and bank), shows the text as it will paste, with or without labels, and remembers your pick on the device.
- Clients and projects are archived, not deleted, so their time stays.
Pull requests
Shows in the navigation once GitHub, GitLab or Bitbucket is connected.
- To review, Mine, and Merged behind a toggle.
- Each one says what it needs from you: review, re-review after new commits, reply, changes requested or CI failing, ready to merge.
- Map a repo to a project once, and its pull requests show in that project's colour.
- ▶ times a review, or the changes asked for on your own.
- Read only: a tap opens it in the browser.
Integrations
Master data → Integrations → Add connection, with a guide to each token.
- Jira and ClickUp: tickets assigned to you come in as tasks, with their description.
- GitHub and GitLab issues assigned to you come in the same way, from gitlab.com or a client's own GitLab.
- GitHub, GitLab, Bitbucket for pull requests.
- Claude, OpenAI or Gemini with your own API key, for Tidy.
- Everything syncs every five minutes; ↻ on Tasks syncs now.
Pomodoro
- Focus phases with short and long breaks, on Today. The timer is the same on every device.
- On the desktop a running round also shows in the window bar, with its ring and countdown; a click opens the dial with pause, skip and reset.
- Each device rings when a phase ends. The bell on the card rings your phone even with the app closed, for the round you walk away from.
- Settings → Pomodoro: the lengths and the sound, from Chime to Starship computer.
- Show the pomodoro card on Today (desktop, this device, on by default): turned off, a running round shows in the window bar only. Focus on Today still starts one.
Notifications
Settings → Notifications has a switch for each, and the times of the summary and the journal nudge.
- Task reminders, at the time set on a task.
- Morning summary: today's and overdue tasks and the cards due, at a time you pick.
- Long timer: one notice after eight hours.
- Pull requests that come to need you, and tickets newly assigned or moved.
- Goals on Monday, and what waits to be invoiced on the month's first working day.
- Journal nudge: on a working day's evening (18:00, or a time you pick), while today's journal is still empty, the day's done tasks and hours. A tap opens the day ready to write, even after midnight.
- A day without tracked time or a done task, like a day off or a holiday, gets no journal nudge; text or ink on a handwritten page counts as written.
- Public holidays: Settings → Working days can make Austria's or Germany's nationwide holidays days off. Goal pace, the billing day and the journal nudge then skip them; on 1 January the billing day moves to the next working day.
- Tapping one opens its page.
The window bar
Desktop: on top of the window, on Linux and on the web.
The app draws its own bar: the logo above the sidebar, the search box in the middle, and on the right only what is running or needs you.
- 3 to review shows while review questions are due and starts the review.
- The pomodoro shows while a round is on; a click opens its dial.
- The eye hides amounts everywhere on this device: Today, Time and Reports.
- The task panel button closes the open task, or brings back the last one you had open.
- Then minimise, maximise and close. Tiling window managers like Hyprland or sway place windows themselves, so there the bar has no window buttons.
- Drag the bar's empty space, the logo or a page's title to move the window. A double click maximises it, a right click opens the window menu.
- Back and Forward after the logo, Alt← / Alt→ or the mouse's side buttons, go through the pages you visited. Tasks opened in the panel add no steps: Back goes to the page before, as you left it.
- The window title shows the running timer, e.g. "▶ 0:42 · Globex: Send invoice", so the taskbar shows it too.
- The page and the task panel are panels on the window's darker base, which the bar and the sidebar sit on.
- On the web the bar is the same, without the window buttons and without Back and Forward: the browser has those.
Your devices
- Live: what one device changes shows on the others as it happens.
- System tray (desktop): shows the running timer and pomodoro, stops the timer, opens a new task or note.
- Android app icon: long-press it for New task, New note, Start call and Start timer.
- App lock (Android): unlock with your fingerprint.
- Appearance and language: light, dark or as the system; English or German.
- Settings → "Show the introduction again" replays the welcome tour.
Keyboard
| Keys | Where | Does |
|---|---|---|
| CtrlK | Anywhere | Search and command palette |
| CtrlEnter | Command palette | Add what you typed as a task |
| Alt← / Alt→ | Desktop app, outside text fields | Back / forward |
| Q | Outside text fields | Add task |
| Ctrl1 … 6 | Outside text fields | Go to the sidebar's pages, in order |
| CtrlShiftSpace | Anywhere | Stop the timer, or start one |
| CtrlB | Outside a note | Collapse or expand the sidebar |
| ? | Outside text fields | List every key |
| J / K | Task lists | Next / previous task |
| X | Task lists | Tick the task off, or reopen it |
| Enter | Task lists | Open the task |
| Esc | Task panel | Close it |
| E | Reading a note | Edit it |
| Esc / CtrlEnter | Writing a note | Finish writing, like Done |
| CtrlB / CtrlI | Writing a note | Bold / italic |
| Ctrl0 … 3 | Writing a note | Text, heading 1, 2, 3 |
| CtrlShift8 / 9 | Writing a note | Bullet list / to-do |
| Tab / ShiftTab | In a list | Indent / outdent |
| Space, 1, 2 | Review | Show the answer, forgot, got it |
| CtrlZ / CtrlShiftZ | Handwritten page | Undo / redo |
| Ctrl+ / Ctrl− | Handwritten page | Zoom in / out |