Keystone
Guide

Learning Keystone

Part 1 builds a small project from an empty file to a tracked, costed plan with a what-if branch, in about twenty minutes. Part 2 is the reference to come back to.

Shortcuts are shown for macOS first, then Windows: ⌘ on a Mac is Ctrl on Windows, and ⌥ is Alt.

Part 1 · Your first project

We'll plan a kitchen renovation: a few tasks in two phases, a milestone at the end, two people and a crew. Every step works the same on macOS and Windows.

1. Start a project

  1. Choose File › New (⌘N / Ctrl+N). Each project opens in a tab of its own; Window › Next Project (⌘`) moves between them.
  2. Choose File › Project Information… (also under Project). On the General tab, leave Schedule from: at Project Start Date and type the Start date: of your project.
  3. The Options tab says how long a day, a week and a month are (Hours per day, Hours per week, Days per month), the Currency symbol, the Date format and the scheduling options. The defaults are 8 hours a day, 40 a week and 20 days a month.

Want something to explore first? File › New from Sample (House) opens a finished house-build plan.

2. Type the tasks

The table on the left starts with the Entry columns: Mode, Name, Duration, Start, Finish, Predecessors and Resource Names. Click the Name cell of the first empty row and start typing; Enter or Tab moves on, F2 edits a cell that already has something in it.

Type these names, with a duration for each:

NameDuration
Plan(leave empty)
Measure the room1d
Draw the design3d
Build(leave empty)
Remove old units2d
Rewire3d
Fit cabinets1w
Tile the walls2d

A duration is a number and a unit: 3d, 1w, 4h, 2 wks. A number alone is in days. Add ? for an estimate (3d?). See What you can type for all of it.

Don't type the Start and Finish dates: Keystone works them out. A date typed into Start pins the task with a Start No Earlier Than constraint, the way Microsoft Project does.

Other ways to add rows: Insert › New Task (the Insert key on a Windows keyboard) puts a new task in at the selected row, and Edit › Delete Task (Delete) takes it out. Edit › Fill Down (⌘D) copies the top cell of a selection down.

3. Build the outline

Select Measure the room and Draw the design, then choose Project › Outline › Indent (⌥⇧→ / Alt+Shift+Right). They move under Plan, which becomes a summary task: its bar spans its tasks, and its dates, work and cost add up from them. Indent the four tasks under Build the same way.

  • With a task's Name cell selected (not being typed in), Tab and ⇧Tab indent and outdent too.
  • Outdent is ⌥⇧←; Move Up and Move Down are ⌥⇧↑ and ⌥⇧↓.
  • The triangle by a summary folds it. Project › Outline › Show All Subtasks and Hide Subtasks fold everything at once.
  • Format › Project Summary Task shows a row for the whole project at the top, and Format › Outline Number numbers the rows 1, 1.1, 1.2…

4. Add a milestone

Add one more task at the bottom, outdented to the top level: Kitchen ready, with a duration of 0. A task of no length is a milestone, drawn as a diamond. Insert › Milestone adds one directly.

To give it a date it must not miss, open Project › Task Information… (⇧F2, or double-click the row or bar), go to Advanced and type a Deadline:. The deadline is marked on the chart, and the task is flagged if it finishes after it. The same tab sets a Constraint type: and Constraint date:.

6. Or type the whole plan

Steps 2 to 5 can be done in one go. Choose View › Type to Plan (⌘⇧O / Ctrl+Shift+O) and type the plan as an indented outline:

Kitchen renovation
  Plan
    Measure the room 1d @Sam
    Draw the design 3d after Measure the room @Sam
  Build
    Remove old units 2d after Draw the design @Crew
    Rewire 3d after Remove old units @Ben
    Fit cabinets 1w after Rewire @Crew
    Tile the walls 2d ss Fit cabinets +2d @Crew 50%
  Kitchen ready milestone after Fit cabinets, Tile the walls

As you type, the panel reads each line, underlines mistakes in red, and previews the tasks it will make, scheduled with the rest of the plan. Tab and ⇧Tab indent lines, and Enter keeps the indentation. Press Add (or Insert when a task is selected), or ⌘Enter, to put it in as one step you can undo. Append adds it at the end, and Replace Selected puts it in place of the selected tasks.

Going the other way, Insert › Edit Selection as Text turns the selected tasks into an outline to edit; Update puts them back. The panel has three examples to start from (House, Software, Event).

The Type to Plan panel: an indented outline on one side, the tasks it makes previewed on a Gantt chart.

7. See the critical path

Choose Format › Critical Tasks. The tasks that set the finish date turn red, with the links between them: delay any of them and the project finishes later. Here that's every task except Tile the walls: it finishes a day before Fit cabinets does, so it has a day of slack.

  • Format › Slack draws each task's slack as a thin line after its bar.
  • To see the numbers, add a column: Insert › Column… and pick Total Slack (or Free Slack, Early Start, Late Finish…).
  • View › Filter shows only some tasks (critical ones, for example), and View › Highlight marks them without hiding the rest.
  • Options for it are on Project Information › Options: Critical if slack ≤ and Calculate multiple critical paths.

Keystone schedules again after every change. Project › Calculate Project (F9) does it by hand.

8. Set working time

The project's calendar says when work can happen. Choose Tools › Change Working Time…:

  • On the Exceptions tab, press Add and give a holiday its name and day (or days). Tasks step around it. An exception can also be a day worked that normally isn't, such as a Saturday.
  • The Work Weeks tab has the default week, which sets the hours of each weekday, and other work weeks: different hours for a named stretch of days, a summer schedule for example.
  • The month preview shades working, nonworking and exception days, and follows what you type. OK puts it all in as one step you can undo.

The dialog can set the project's calendar and the selected tasks' calendar too. Resources have calendars of their own, picked in the Resource Sheet's Base Calendar column.

9. Add people and assign them

Choose View › Resource Sheet and type a resource on each row: Sam, Ben and Crew. The Type column says what each one is:

  • Work: people and equipment, paid by the hour.
  • Material: things used up, counted in the Material Label unit (m3, tiles).
  • Cost: a cost you type on each task, such as a permit fee.

Max Units says how much of a resource there is: 100% is one person full time, and 300% a crew of three.

Now go back to View › Gantt Chart and assign them. Either:

  • type in a task's Resource Names cell, names parted by commas, each with units in square brackets if it isn't full time: Crew[50%], Ben. A name that isn't in the project becomes a new resource; or
  • open Project › Assign Resources… (⌥F10 / Alt+F10). The window stays open beside the plan and follows the selection: tick resources, type their units, and press Assign. Remove and Replace are there too.

Assigning work turns duration into work: a 3-day task with one person full time is 24 hours. The Task Usage and Resource Usage views show that work day by day.

10. Fix overallocations

A resource given more work at once than it has units is overallocated: its name turns red in the Resource Sheet, and the Resource Graph shows the peaks above its limit.

  • Tools › Next Overallocation selects the next task that causes one and scrolls to it.
  • Tools › Level All delays tasks just enough that nobody is overbooked; Level Selection levels only the selected tasks. A sheet lists what moved and anything still overallocated, and why.
  • Tools › Leveling Options… sets how: the order tasks give way in, whether to level only within slack, whether leveling may split tasks, and the rest.
  • View › Leveling Gantt draws each task's bar from before leveling under its bar, with the delay as a line. Tools › Clear Leveling takes the delays out again.
The Leveling Gantt: each bar with a thin bar under it where it was before leveling.

11. Add costs

  • In the Resource Sheet, give work resources a Std Rate (45/h) and, if they're paid more for overtime, an Ovt Rate. Cost/Use is charged once per assignment, a call-out fee for example. Material resources' rate is per unit used.
  • A task can carry a cost of its own in the Fixed Cost column, with Fixed Cost Accrual saying whether it falls at the start, at the end, or spread over the task.
  • View › Tables › Cost switches the table to the cost columns: fixed cost, total, baseline, variance, actual and remaining. Tables › Entry brings the usual columns back.

The money format (symbol and decimal digits) is on Project Information › Options.

12. Set a baseline

When the plan is agreed, keep a copy of it to measure against. Choose Tools › Tracking › Set Baseline… and press OK. It saves every task's start, finish, duration, work and cost as Baseline. There are eleven baselines (Baseline, and Baseline1 to Baseline10) if you want to keep more than one, and each can be set for the whole project or only the selected tasks.

Format › Baseline draws the baseline under each bar, and View › Tables › Variance lists how far each task has moved from it.

13. Record progress

  1. Set the date you're reporting up to: Tools › Tracking › Status Date….
  2. Select a task and mark how far it is: Project › Tracking › 0% / 25% / 50% / 75% / 100% Complete, or drag the end of its progress on the bar. For more, Update Tasks… takes % complete, actual and remaining duration, and the actual start and finish.
  3. Mark on Track marks the selected tasks done as planned up to the status date. Update Project… does that for the whole project (or the selection) through a date you give, or reschedules unfinished work after it; Reschedule Unfinished Work moves what's left past the status date.
  4. See it: View › Tracking Gantt draws each bar over its baseline, and View › Progress Line joins how far each task has got. View › Earned Value has the earned-value table (planned value, earned value, actual cost, SV, CV, SPI, CPI and the estimates at completion).
The Earned Value view: a table of planned value, earned value and actual cost with the variances and indexes for each task.

14. Try a what-if

Suppose the cabinets might arrive a week late. Rather than change the plan and try to remember how it was, branch it:

  1. Choose Project › Branch Plan… and name the branch, say Late cabinets. A copy of the plan is kept as a scenario, and you go on editing.
  2. Change what you like: make Fit cabinets 2w, move tasks, reassign people.
  3. Choose Project › Compare Scenarios. Cards at the top compare the finish dates, work and costs; the Gantt chart has a thin bar per plan in each row; and the tasks that moved are listed. Up to three scenarios can be compared with the plan you're editing.
  4. The Scenarios side panel (View › Scenarios Panel) switches between plans, renames, duplicates and deletes them. Project › Switch to Scenario does the switching from the menu.

For one quick question there's Project › What If: This Task Took Longer…, This Resource Left… and This Task Started On…. The answer comes at once from a temporary branch, with Keep Change, Save as Scenario and Discard.

Compare Scenarios: cards with each plan's finish, work and cost, and a Gantt chart with one thin bar per plan in each row.

15. Save and share

File › Save (⌘S) saves a .keystone file: everything, scenarios and baselines included. Save As… is ⌘⇧S.

To send the plan to someone with other software, use File › Export: Microsoft Project XML, Primavera P6 XER, the table as CSV or an Excel workbook, or a PDF or picture of the chart. See Files, printing and pictures.

That's the whole cycle: plan, link, resource, cost, baseline, track, and ask what if. The rest of this page is the reference.

Part 2 · Reference

The views

Every view is on the View menu and the View tab of the ribbon. All of them share one selection: select a task in the network and it's selected in the Gantt chart.

Gantt Chart
The table and the bars. Zoom with View › Zoom In and Zoom Out (⌘=, ⌘-), Entire Project (⌘⇧F) or a View › Timescale level; Scroll to Task (⌘⇧T) brings the selected bar into view. Format has the bar and text styles, gridlines, the timescale, the layout and the columns.
Tracking Gantt
Each bar drawn over its baseline, with its progress.
Network Diagram
A box per task, in columns by link order (or Network: By Date), with the links between them. Choose the boxes: Full Cards, Compact Cards or CPM Cards, the textbook card with ES, EF, LS and LF in working days from the project start (or CPM Dates for dates) and the slack above it. Network: Start and End Nodes adds a node for the project's start and finish (on by default for CPM cards); Critical Path in Red and Link Labels do what they say. Dragging from one box onto another links them finish-to-start. The wheel scrolls, ⌘ + wheel or a pinch zooms, and Network: Fit shows it all. File › Export Network Diagram as PDF… or as Picture… saves it.
The Network Diagram: task boxes in columns joined by link arrows, the critical path in red.
WBS Chart
The outline as a work breakdown structure: the project at the top, each summary over its tasks, every box with its WBS code, its name, its dates, duration and % complete, and a progress bar. Choose the layout in the strip above it: Tree (children side by side), Compact (tasks stacked under their summary, the usual WBS chart) or Indented (one box a row, as an outline). Levels shows only so many levels under the project. The round button under a box folds what's under it, or opens it again (- and + do the same for the selected box). Dates, Duration, % Complete and Critical Path choose what the boxes show. Click a box to select its task, double-click it for Task Information (the project's box opens Project Information); the arrow keys go up to the summary, down to the first task under it, and across to its neighbours. File › Export WBS Chart as PDF… or as Picture… saves the whole chart.
The WBS Chart: the project at the top, its phases below, and each phase's tasks stacked under it.
Calendar
The tasks on a month or a week (Calendar: Month, Calendar: Week), with or without the summary tasks.
Task Usage and Resource Usage
The work of each assignment, day by day, under its task or its resource. (The cells show work; it isn't typed there yet.)
Resource Sheet
The resources as a table: type, label, initials, group, max units, rates, cost per use, accrual and base calendar.
Resource Tree
The resources by their Group, as a tree under the project. A slash in the group makes levels: Trades/Electrical puts the resource under Electrical, under Trades. Each box has the resource's kind and max units, its work and cost (Totals), and is red when overallocated (Overallocated); a group's box adds up the resources under it. Resources read from a P6 file come in with the parent resources above them as their group. It has the same layouts, levels and folding as the WBS Chart; double-click a resource for Resource Information.
The Resource Tree in dark mode: resources under their groups, an overallocated one in red.
Resource Graph
One resource's load over time against its limit, overallocations in red. View › Resource Graph Pane shows it under the Gantt chart.
Team Planner
A band for each person with their tasks as bars, overallocated stretches shaded red, and the tasks nobody works on at the bottom. (Dragging bars between people isn't done.)
The Team Planner: one band per person with their task bars, overallocations shaded red.
Timeline
View › Timeline docks a strip above the view with the tasks you add to it (right-click a task › Add to Timeline), as bars or callouts, and the milestones. Drag its window to scroll the chart, or its edges to zoom.
S-Curve
Planned against actual, adding up over time: Cost, Work or % Complete (View › S-Curve Measure). It draws the plan as the baseline had it, as scheduled now, and what is done so far up to the status date, with the earned value. View › S-Curve Pane puts it under the Gantt chart, on the chart's timescale.
The S-Curve view: planned and actual cost over time.
Reports
Project Overview, Cost Overview, Work Overview, Resource Overview, Critical Tasks, Late Tasks, Milestones and Earned Value Over Time (View › Reports). Each one exports with File › Export Report as PDF…; Export All Reports as PDF… makes one file of them all.
Earned Value, Leveling Gantt and Compare Scenarios
See steps 13, 10 and 14.

The task table can switch columns with View › Tables: Entry, Tracking, Variance, Cost, Work, Baseline and Earned Value. View › Group By, More Filters…, AutoFilter… and Sort By… arrange it; Clear Filter, Sort and Group puts it back. View › Task Inspector opens a side panel that explains why the selected task is where it is.

The command palette

Press ⌘K (Ctrl+K) and type. The palette finds every command of the app, every view, and the project's tasks and resources; the commands you use most come first. Start with > for commands only, @ for resources, or # and a number for a row. ↑ and ↓ choose, Enter runs, Esc closes.

It also takes actions with values:

TypeTo
zoom monthszoom the timescale
filter criticalapply a filter
set duration 5dchange the selected tasks
link 3 to 7link two rows
go to Framing, #12jump to a task by name or row
@Anafind a resource
add Pour slab 3d after Formworkadd a task, written as in Type to Plan
50%set % complete

Edit › Go to Task… (⌘J) opens it ready to find a task.

The command palette over the Gantt chart, listing matching commands and tasks.

Keyboard shortcuts

Help › Keyboard Shortcuts lists them in the app too.

CommandmacOSWindows
File and window
New Project⌘NCtrl+N
Open…⌘OCtrl+O
Save⌘SCtrl+S
Save As…⌘⇧SCtrl+Shift+S
Close Project⌘WCtrl+W
Print…⌘PCtrl+P
Next Project / Previous Project⌘` / ⌘⇧`Ctrl+` / Ctrl+Shift+`
Editing
Undo / Redo⌘Z / ⌘⇧ZCtrl+Z / Ctrl+Shift+Z
Cut / Copy / Paste⌘X ⌘C ⌘VCtrl+X Ctrl+C Ctrl+V
Select All⌘ACtrl+A
Edit CellF2F2
Fill Down⌘DCtrl+D
DeleteDeleteDelete
Find… / Find Next⌘F / ⌘GCtrl+F / Ctrl+G
Go to Task…⌘JCtrl+J
Tasks
Insert TaskInsert (on keyboards that have it)Insert
Task Information…⇧F2Shift+F2
Indent / Outdent⌥⇧→ / ⌥⇧←Alt+Shift+Right / Left
Move Task Up / Down⌥⇧↑ / ⌥⇧↓Alt+Shift+Up / Down
Link Tasks / Unlink Tasks⌘F2 / ⌘⇧F2Ctrl+F2 / Ctrl+Shift+F2
Assign Resources…⌥F10Alt+F10
Type to Plan⌘⇧OCtrl+Shift+O
Calculate ProjectF9F9
View
Command Palette…⌘KCtrl+K
Zoom In / Zoom Out⌘= / ⌘-Ctrl+= / Ctrl+-
Zoom Entire Project⌘⇧FCtrl+Shift+F
Scroll to Task⌘⇧TCtrl+Shift+T
In the table and in Type to Plan
Indent / outdent the task or lineTab / ⇧TabTab / Shift+Tab
Put the outline in (Type to Plan)⌘EnterCtrl+Enter

Function keys on a Mac laptop may need fn held down, depending on the keyboard setting.

What you can type

Durations and lags

A number, then a unit, then perhaps ? for an estimate. Spaces are optional, and a number with no unit is in days.

UnitWriteWorking time
Minutesm min mins minuteas typed
Hoursh hr hrs houras typed
Daysd dy day daysHours per day (8)
Weeksw wk wks weekHours per week (40)
Monthsmo mon monthDays per month (20)

Put e in front for elapsed time, which runs through nights and weekends: 3ed is three calendar days, 2ew two calendar weeks (a curing slab, a delivery). Examples: 5, 5d, 5 days, 2.5 wks, 4h?, 3ed. A duration of 0 makes a milestone. Lags take the same units, with a sign (+2d, -1d), or a percentage (+50%).

Predecessors

Row numbers parted by commas, each perhaps with a link kind (FS, SS, FF, SF) and a lag: 3, 3FS, 3SS+2d, 12FF-1 day, 4SF+50%, or several: 3,5FS+2 days,7SS.

Resource Names

Names parted by commas (or semicolons), each perhaps with units in square brackets: Ana, Crew[50%], Ana, Ben[200%]. Units can be written 50%, 50 or 0.5.

Type to Plan lines

One task per line; indentation (tabs, or steps of two or four spaces) sets the outline. Bullets (-, *, •) and numbers (1., 1.2) in front are ignored. A line with no duration and lines under it is a summary.

Name [duration] [after A, B | ss A +2d | ff A -1d | sf A] [@Res, @Res 50%] [by date | on date | from date] [milestone | !]
WriteMeans
after Footings or fs Footingsfinish-to-start link from the task named Footings. Several: after Wiring, Plumbing
ss Framing +5d, ff Beta -1d, sf …the other link kinds, with a lag or lead after the name
after #3a link from row 3 of the project
"Sign off on plans"a name in quotes, when it holds words like on or after
@Ana, @Crew 50%, @Crew 2resources, with units (2 is two people). New names become new resources
@Concrete [12 m3]a material and the amount used
@Venue $12000a cost resource and the amount
by 2026-12-01a deadline
on … / from …must start on / start no earlier than. snet, snlt, fnet, fnlt, mso, mfo and alap work too
milestone or !a milestone

A name is looked for among the lines above (nearest first), then below, then among the project's tasks. Mistakes don't stop the reading: each is underlined and the rest goes in.

Files, printing and pictures

ToChoose
Open a Keystone file, a Microsoft Project file (.mpp or .xml) or Primavera P6 (.xer)File › Open…, or drop the file on the window
Bring in tasks from a spreadsheetFile › Import › CSV File… or Excel Workbook… (its first sheet)
Save for Microsoft Project or P6File › Export › Microsoft Project XML… or Primavera P6 XER…
Save the tableFile › Export › Table as CSV… or Excel Workbook…
Save the chartFile › Export › PDF… or Picture (PNG)…; Edit › Copy Picture puts it on the clipboard
PrintFile › Page Setup…, Print Preview, Print… (⌘P)

Importing reads the header row by Microsoft Project's field names (Name, Duration, Start, Finish, Predecessors, Resource Names, Outline Level, WBS, % Complete, Notes, Cost, Work and the rest); any other column becomes a custom text field named after its header. The outline comes from an Outline Level column, or WBS or outline numbers, or names indented with spaces. Anything that can't be read is listed by row and column, and the rest goes in.

Microsoft Project's own .mpp files, from Project 2000 to Project 2024 and 365, open like any other: tasks, links, calendars, resources and their rates, assignments, baselines and custom fields come in, and what can't be kept is listed when the file opens. Keystone doesn't write .mpp: to hand a plan back to Microsoft Project, export it as Microsoft Project XML, which Project opens. Files saved by Project 98 and files with a password can't be opened; in Project, save them again without the password, or as XML.

Microsoft Project XML keeps one link between two tasks, so a P6 pair (SS and FF between the same two tasks) is exported as its first link. Keystone's files follow the published formats and read back in other tools, but haven't been tried in Microsoft Project or P6 themselves.

Crash recovery

While a project has unsaved changes, Keystone writes a copy of it every half minute into its data folder. Saving, closing the tab or quitting normally deletes the copy. If Keystone stops without quitting, the next time it starts it opens each copy in a tab of its own as an unsaved project and says so: save it to keep it.

Updates and privacy

Keystone looks for a new version as it starts and every few hours while it's open, downloads it in the background, checks it, and installs it when you quit. The Help menu has:

  • Check for Updates…: look now, and say what was found.
  • Check for Updates Automatically: off, and Keystone only looks when you ask.
  • Install Updates Automatically: off, and a bar under the ribbon offers each update instead.
  • Send Anonymous Usage Statistics: off, and nothing is counted.

Your projects never leave your computer. The privacy page lists exactly what is sent.

Something here doesn't match the app, or a step isn't clear? Write to admin@syncster.dev.