Help & support
How Weekscope works
A guide to every part of Weekscope — logging work, reports, the calendar, importing from GitHub, reminders and your data. Questions? Email support.
Getting started
Three habits are all it takes. Weekscope does the rest.
- 1. Set up your week
- In your profile (click your name at the top of any page), add your name and workplace, the projects you work on, and the days and hours you work. It takes a minute and makes everything after it faster.
- 2. Log as you go
- Whenever you finish, start or get stuck on something, add a short entry. A title and a status is enough — you can add details later.
- 3. Review on Friday
- Create your weekly report. Weekscope fills it from your log, you check each line, then copy it or download a PDF for your manager.
Overview
Your week at a glance, and what’s left before your report is ready.
- The numbers
- Work entries, tasks completed, tasks still open and blockers for the week. Tasks are counted once even if you logged them on several days — the latest status wins.
- Report readiness
- A short checklist of what your report still needs: missing workdays, open tasks without a reason, commitments for next week. Work through it and your report is ready to send.
- Deadline and weeks
- Set a weekly reporting deadline in Settings to see a countdown here. Use the arrows to look at other weeks. New period moves your log to the next week and can carry unfinished tasks forward as Planned.
Daily Log
Your work, day by day. This is the record everything else is built from.
- Choosing a day
- Pick a day in the week strip, or use the ← and → keys. Workdays with nothing logged turn red so gaps are easy to spot; days you don’t work are greyed out and never flagged.
- Days off
- Weren’t working? Choose “I wasn’t working” and mark the day as a day off, public holiday, leave or sick. It stops counting as missed and shows hatched on the calendar.
- Changing entries
- Open any entry to edit it. You can also duplicate an entry — handy for work that continues the next day — or delete it.
Adding work entries
Press N anywhere, or use Add work entry. Only the date, project and title are required.
- Project and ticket
- Your saved projects appear as one-click chips under the Project field, with your starred project filled in. Weekscope remembers ticket IDs and names you’ve used, and fills in the rest when you pick one.
- Status
- In Progress, Completed, Delivered (handed over or released), Blocked and Icebox (for later, not started). Only Completed and Delivered count as done — Weekscope never assumes work was finished.
- The Icebox
- Put work you haven’t started in the Icebox: ideas that were talked about, or tasks for later. It isn’t logged on any day and stays out of your reports. When you start one, it becomes that day’s work, In Progress, its timer starts, and Weekscope remembers how long it waited. The snowflake on an entry puts it back in the Icebox: its timer stops, the time worked stays logged, and the timer carries on from there when you start it again.
- Timing your work
- Press play on one of today’s entries while you work on it, and pause when you stop or switch; its time adds up across the day. Two timers can run at once (you’re working on both); starting a third asks first which to pause — both, one, or none — and starts once you’ve chosen. Stop (the square) means you’re done with it for today: it asks whether to continue tomorrow, mark it finished, move it to the Icebox or delete it, and the timer stops once you’ve chosen (close it and the timer keeps going). On bigger screens running timers sit in the top bar by ticket ID, or by their number in today’s log when there are several; on phones they’re on the tickets. Continuing unfinished work from an earlier day starts its timer too. You can still type a time for past days, or adjust one that’s off. A timer left running overnight stops at the end of your workday.
- Short breaks
- Stepping away for a stretch or a coffee? Press the cup beside a running timer: it pauses for a short break and carries on by itself when the break is over, even if Weekscope is closed by then. Back early, press play; or press × to keep it paused. Choose how long a break is in Settings → Timer.
- Starting and ending the day
- While no timer is running, the top bar offers “Start the day” from half an hour before your workday starts until half an hour after, and “End the day” around when it finishes. Starting the day asks what you’re starting with — today’s work, or what was still in progress last time — and starts its timer. Ending it shows today’s time and work, lets you complete what’s finished, and says goodbye until your next workday. Outside your work hours — before your day starts, and once it’s done — “Overtime” takes its place, never during them: if work comes in then, pick it and its timer counts as overtime, without asking. In Settings → Timer, show the buttons all day instead (starting until halfway through your workday, then ending), or not at all. On tablets and computers, today’s card in the Daily Log follows your day too: the sun rising, high from lunch, setting after work, then the moon and stars, asleep once you’re done.
- Lunch and overtime
- Set your work hours, and a lunch break, in Settings → Profile. Running timers pause for lunch and carry on after it (or wait for you to start them again: Settings → Timer), and a few minutes before, you can choose to work through lunch instead. Starting a timer outside your work hours (before or after them, on a day you don’t work, or on a day off) asks whether it’s overtime; overtime is marked on the entry and added up on its own. A timer still running when your workday ends asks too: count what follows as overtime, stop it at the end of the day, or keep it as normal time. In Settings → Timer it can stop by itself at the end of the day instead, or keep running.
- Overtime in an organisation
- An organisation can set its employees’ work hours, lunch break and holidays, and how overtime works: counted as overtime, approved first, or not allowed — before or after work hours, on weekends and days off, and on holidays — with weekly limits, overall or per project. When overtime needs approving, the timer doesn’t start; ask for overtime instead, with the day, the project, how long and why, and copy in people from your organisation. It’s emailed to your organisation. Once approved, your timer on that project runs for the time approved that day, then stops. Admins answer requests in Organisation → Overtime.
- Story points
- Points follow the Fibonacci scale, each with a guide in hours: 1 very small (2–4 hours), 2 small (4–8 hours), 3 medium (8–16 hours), 5 moderately complex (16–32 hours), 8 complex (32–56 hours), 13 very complex (56+ hours). Leave points empty and Weekscope works them out from the time spent on the task; if the time goes past the guide for the points you chose, the entry says so. At 13 points, consider splitting the task.
- Picking up where you left off
- Anything still In Progress or Blocked on the last day you logged is offered when you add today’s first entries. Continue it in one click: same ticket and details, on today.
- Only today and earlier
- You can log work for today and past days, but not for days still to come. Use the Icebox for work you’re planning; days off can still be marked ahead.
- Screenshots and PDFs
- Drop, paste or upload a screenshot or PDF. Weekscope reads it on your device and suggests a title, ticket, link, time and project for any empty fields — you can undo the suggestions. If the file lists several tasks, you can create them all at once.
- Effort, blockers and commitments
- Pick points (or let the time spent decide), time it or type a time (like 1h 30m), and add what you did, what’s blocking you, and where unfinished work is at. Something happened as you worked? The speech-bubble icon on the entry notes a blocker (it pauses the timer) or why it’s taking longer, and your report picks it up. Working on something you’d finished? Say whether a revision was requested or it was rejected — on the entry, or from the report — and the report words it that way. Tick “commitment” for work you’re promising next week — it appears under Next week in your report.
- Finishing work
- While work is in progress, its description is what you’re doing that day. Finished it? Press the check on its row (or set the status to Completed or Delivered): the description becomes what was done, and you can add testing instructions — how someone can check the work. They’re printed under it in your weekly report, and you can edit them there too.
- Lists and pasted text
- Work performed and Notes keep the lists and paragraphs of what you paste — from a web page, Google Docs or Word — as “- ” bullets and numbered items. In a list, Enter starts the next item and Enter on an empty item ends the list; Shift + Enter adds a plain new line.
Day flow
Your day on one line: what you worked on and when, breaks, lunch, and time with nothing on a timer.
- Opening it
- Day flow has its own page in the sidebar: your week’s days, each on one line — open one to bring it into focus, in full. It also sits small by the date in the Daily Log, with the day’s on-time checks and points: hover it for the day at a glance, click it to open the whole day, and Minimise to put it away. There it always starts small, so your work comes first.
- Reading the line
- Each stretch of the line is what was going on then: work in its project’s colour (overtime striped), breaks and lunch in amber, and small ticks where nothing was on a timer. A tick in a green circle above the line marks work you finished, and the orange line is now. Hover any part for what it was and when. Every moment, in order, is listed under it.
- What it notes
- Your timers do most of it. Weekscope also notes when you open it, start and end the day, take a break or choose to work through lunch, and log or finish work — times only, never your notes or descriptions. It keeps four months of days, on each of your devices and in your account.
- Your usual day
- Under the day: when you usually start and finish, your busiest hours, how much of your work happens before lunch, how often you take breaks and keep lunch — from the last four weeks.
- Who sees it
- Only you, unless your organisation shares it. Then its admins see either the team’s patterns without names (from three people up) or each person’s day. Day flow and Settings → Day flow say which.
- Turning it off
- Settings → Day flow: turn it off and nothing more is noted, and erase what it has kept. When your organisation keeps Day flow on for everyone, ask there to be excused — its admins answer, and once excused it’s your choice.
- In Glance
- Glance’s Today page shows the day so far on the same line. Click it to open the Daily Log.
Calendar
Step back and see a month or a whole year.
- Month and year
- The month view shows each day’s entries; choose a day to see its details and add to it. The year view shades each day by how much you logged, with days off, gaps and non-workdays easy to tell apart.
Weekly reports
Your status report, assembled from your log in the standard template.
- Creating a report
- Choose a week and whether it covers all your projects or just one. Weekscope sorts your work into This week (Done, and What slowed me down) and Next week (Committing to), which is where work that isn’t finished carries on.
- Editing
- Every line is editable, and you can add your own. Mark the report Final when it’s ready. If your log changes after you created the report, Weekscope tells you and lets you pull the changes in.
- Sharing
- Copy the report as text or download a clean PDF. Page size, links, page numbers and branding are set in Settings → PDF export.
Importing
Bring in work from GitHub, a spreadsheet or another tool.
- From GitHub
- Choose Import, then Import from GitHub. Pick a week and Weekscope brings in your merged and open pull requests and the issues assigned to you as drafts — merged or done ones as Completed, open ones as In Progress. Untick anything you don’t want, then import. If you signed in with GitHub you can include private repositories; otherwise enter a username to bring in public activity.
- CSV and JSON
- Import a CSV or JSON file from the Overview. Download the template to see the columns. Anything that could be read two ways — dates like 03/04, unfamiliar statuses, rows without a project — becomes a question for you, and duplicates are detected before anything is saved.
Profile
Everything about you. Click your name at the top of any page (on a phone: Settings → your name).
- Your details
- Your photo, name (printed on reports) and workplace.
- Projects
- The projects you work on. Star one to fill it in on new entries.
- Work week
- The days and hours you work. Only workdays are expected to have entries.
- Reminders
- On each workday, a reminder half an hour before you start (unless you’ve already logged something) and half an hour before you finish, to close your day — never on days off. Optional ones at the start of your week and at the end of it, at times you choose. Weekscope also sends one catch-up on Saturday morning if your week isn’t complete. They come by email, and as notifications on devices where you turn them on (Settings → Notifications). Turn any of them off in Profile → Reminders.
- Phone notifications
- Turn on Notifications on this device in Settings → Notifications, and your reminders arrive as notifications too, alongside the emails — plus one when your lunch break starts and a timer is still running. Tap a notification to open Weekscope where it helps. Each phone or computer is turned on by itself. On iPhone and iPad they work in the installed app: add Weekscope to your home screen first.
- Installing the app
- Weekscope installs from your browser, no app store needed: it then opens from your home screen in its own window, like any other app. On Android and computers, use Install the app in Settings → The app, or your browser’s menu. On iPhone and iPad, open Weekscope in Safari, tap Share, then Add to Home Screen.
- Organisation
- Join your workplace when an admin invites you (the invitation opens with their welcome), or start an organisation and invite your team. Your organisation sees reports you submit and simple counts. Submit a report from its page: admins read it in Weekscope, with when you sent it, and can send it back with a note.
- Time sharing
- An organisation can turn on time sharing. Its admins then see members’ projects, tickets, statuses and time — hours per day, week and project, and timers while they run. Weekscope tells members it’s on, with a notice and an eye by their timers. Notes, descriptions and files are never shared.
Settings
How Weekscope itself behaves. Changes save automatically.
- Appearance
- Light, dark, or follow your computer.
- Reporting
- When your reporting week starts, how dates are written, an optional weekly deadline, and whether weeks that have ended can still be edited.
- PDF export
- Page size, links, page numbers and branding on downloaded reports.
- Your data
- Download a full backup (including attached files), restore one, or start over.
Account and backup
Sign in once and your log follows you.
- Signing in
- Sign in with Google, GitHub or your email address. With email, choose a sign-in link or an 8-digit passcode and Weekscope emails it to you — there’s no password to remember. Use the same email each time and you’ll always reach the same account.
- Everywhere you work
- With an account, your entries, reports, days off and settings are backed up and kept in sync across your devices. Weekscope keeps working offline and catches up when you reconnect.
- Signing out and deleting
- Sign out from the bottom of the sidebar, or delete your account from Profile → Account. Deleting removes everything, everywhere, and can’t be undone — download a backup first if you want a copy.
In an organisation
What changes when you work in an organisation, and what it can and can’t see.
- Joining
- An invitation opens by itself: the organisation’s welcome, with your name and job, a note just for you if they wrote one, what’s expected of you and what they’ll see. Join, decline, or decide later — it asks again in an hour, and waits in your notifications. Or, when your organisation lets anyone with your work email join, join it from Settings → Organisation. Leave from there too; your own log stays with you.
- Submitting reports
- Open a report and press Submit to send it to your organisation’s admins. They can send it back with a note asking for changes; fix it and submit again.
- What it sees
- Your name, job title, the reports you submit and how active you are. Your time, and your Day flow, only if it turns them on — Weekscope tells you when it does. Never your notes, descriptions or files.
- Rules it sets
- Your organisation can fix some settings for everyone: the reporting week and deadline, editing past weeks, work hours, lunch and holidays, overtime, the leaderboard and Day flow. Those show “Set by” your organisation, and some sections may be hidden.
- Your name and title
- Your organisation sets the name you go by there; ask for a different one in your profile. Your job title and level come from it too — or you choose them from its list, when it lets you.
Messages, tasks and notifications
Talk to people in your organisation, get work from it ready to start, and never miss what happened.
- Notifications
- The bell at the top of every page: messages and mentions, tasks sent to you (and what happened to ones you sent), reports sent back, overtime answers, invitations and a new version of Weekscope. Open one to go straight there — an invitation opens itself, and the welcome opens Help and the tour. Mark all read clears the count. Clear one with its ×, or all of them at the bottom of the list; read ones go by themselves after three months. They’re never emailed.
- Messages
- Messages, in the sidebar: write to anyone in your organisation, or start a group with a few people. Type @ and a name to mention someone — they’re told. In a one-to-one conversation, the other person is told about new messages too. Only the people in a conversation can read it.
- By email instead
- Under what you’re writing: Open in email starts a draft in your own email (Gmail, Outlook…) to the people in the conversation, with your message in it; Copy puts it on the clipboard. Weekscope itself never sends it.
- Tasks sent to you
- Work from your organisation arrives lined up in your Daily Log for its day — its title, project, brief, priority and type filled in — with who sent it. Press Start and its timer runs. Can’t take it on? Send it back, with a note. The person who sent it hears when you start it and when it’s finished.
- Sending tasks
- Admins, and people they choose, can send tasks: from a conversation (Send a task), from Messages → Tasks you sent, or from Organisation → People. Pick the day and fill in what they’ll need. Tasks you sent shows how each is going; one not started yet can be taken back.
Running your organisation
For organisation admins: the Organisation space, opened from the sidebar. Your own work stays in My work, and the rules for members don’t bind you.
- People
- Invite one person or a whole team at once, in four steps: type or paste their emails; fill in each person’s name, job title, level and role under the welcome (it changes as you type, and the organisation is filled in for you); add your own message after it if you like; and what’s expected. Everyone gets the same welcome, with their own details. Preview shows exactly what each person will see, and your message and what’s expected can be kept for next time. Change roles and titles, set the names people go by (and answer requests for a different one), send someone a task, choose who else can send tasks, and remove people who leave. You see who’s active, never what they logged.
- Time
- With time sharing on (Settings), see each member’s hours by day, week and project, the tickets still going, and timers running right now. Members are told it’s on.
- Day flow
- In Settings, choose whether Day flow is each person’s choice, on for everyone or off, and what admins see: nothing, the team’s patterns without names, or each person’s day. Organisation → Day flow then shows the team’s usual day — when people start, their busiest hours, and the best time to hand out work — and, if shared, each person’s day on one line: open someone to bring their day into focus. People asking to be excused appear at the top; excuse them, or keep it on.
- Overtime
- When overtime needs approving, requests arrive in Organisation → Overtime. Approve them for the time asked (or more, or less) or decline, with a note — and choose whether the employee is emailed the answer.
- Reports
- Reports your team submits arrive in Organisation → Reports. Read them, download a PDF, or send one back with a note asking for changes.
- Settings
- The organisation’s name and picture, and the rules for members: the reporting week and deadline, editing past weeks, work hours, lunch, holidays and overtime, the sections members see, time sharing, Day flow, the leaderboard, job titles, and whether people with your work email can join without an invitation.
- Activity
- What admins did, and when: invitations, changes to roles and rules, overtime answers, reports sent back and more.
- Closing your organisation
- Admins can’t delete an organisation straight away: at the end of Settings, ask Weekscope to, with a reason. From then it’s closed — members can’t send reports, the Organisation space shuts and it can’t be reopened — and Weekscope deletes it, emailing you when it’s done. Deleting it removes who’s in it, its invitations, the reports sent to it, overtime requests, messages, tasks, activity and settings; everyone keeps their account and their own log. Download the reports you need and tell your team first.
- Moving to a new organisation
- At the end of Settings, choose “We’re moving to a new organisation”: give it a new name and picture, then choose who comes — everyone, with the same roles, job titles and levels, or just you — and, with everyone, whether their work carries on (the reports sent, messages, tasks and overtime requests move over) or starts fresh. Its settings come along too. Weekscope sets up the new one, moves everyone and deletes what’s left of the old one, in one go; everyone who moved is welcomed in on their next visit, and their own logs are theirs either way.
- If Weekscope gives notice
- For inactivity, negligence, misuse or breaking the terms, Weekscope may delete an organisation — always with notice first (usually 30 days, never less than 7), at the top of the Organisation space and by email, with the reason. Agree or disagree there: disagreeing, with why, pauses the countdown until a person at Weekscope has read it. With no answer, it’s deleted when the notice ends, after a reminder a week before.
Privacy
Your work stays yours.
- Nothing is guessed
- Weekscope never invents work, statuses or commitments. Reports only contain what you logged, and you review every line.
- Files stay on your device
- Screenshots and PDFs are read and stored on your device only. Reminder emails only give counts (entries logged, timers running, days missing) and whether your report exists — never what you worked on.
Questions
I don’t work Monday to Friday. Will Weekscope nag me?
No. Choose your workdays in Profile → Work week. Days you don’t work are never flagged as missed, and reminders follow your schedule.
I forgot to log a day. What now?
Pick the day in the Daily Log and add what you did — entries can be added for any date, unless past weeks are locked. If you weren’t working, mark it as a day off instead.
Can weeks lock once they’re over?
Yes. Turn off “Edit past weeks” in Settings → Reporting. Weeks that have ended can then be viewed, copied and exported, but their entries, days off and reports can’t be changed. Turn it back on any time.
Can I use Weekscope on my phone and my laptop?
Yes. Sign in with the same account and your log stays in sync. Attached screenshots stay on the device you added them on.
How do I stop reminder emails?
Switch them off in Profile → Reminders, or use the link at the bottom of any reminder email.
Does Weekscope work offline?
Yes. Everything you do is saved on your device first and backed up as soon as you’re online again.
Keyboard shortcuts
- Add a work entry
- N
- Save the entry you’re editing
- Ctrl / ⌘ + Enter
- Previous / next day in the Daily Log
- ← →
- Close a panel or dialog
- Esc
Still stuck, or have an idea?
Email Max, who makes Weekscope. Every message gets read, usually within a working day.