Tools
Activity
The Activity tool is Spruce's unified feed of everything happening in the project. Unlike a plain git log, it brings together:
- Commits in linked code repositories.
- Pending changes to the Spruce project (artifact drafts, field edits, new views).
- Pending code changes (unstaged, staged, and untracked files).
- Branch switches and worktree activity.
Two surfaces:
| Surface | Where | What it shows |
|---|---|---|
| Global Activity page | Tools section of the sidebar | Project-wide feed, filterable down |
| Artifact-scope Activity tab | The tool panel on an open artifact | The same feed, locked to the open artifact |
The global Activity page
Reach it from the Tools section of the sidebar (⌘⌥A on macOS, Ctrl+Alt+A elsewhere).
Activity page with commits, pending artifact changes, and pending code changes
Filtering
The toolbar at the top filters the feed; filters stack:
- Activity type: commits only, pending only, both.
- Code repo: when multiple repos are linked.
- Date range.
The artifact-scope Activity tab
When an artifact is open, the Activity tab in the tool panel (toggle with ⌘⇧A) shows the same feed, locked to that artifact. Same content model, same items; the panel just trims the chrome and pre-filters to the open artifact.
Revert
Right-click any pending change (on either surface) and pick Revert to discard it. Useful for experimental edits you decide against.
Opening a commit
Click any commit in the feed to open the Diffs and Commits view.
Related
- The tool panel — the panel that hosts the artifact-scope Activity tab.
- Diffs and Commits — the full commit view.
- Branches and Worktrees — where code activity comes from.
- The Sidebar — where the global Activity page lives.