Skip to content

Latest commit

 

History

History
79 lines (59 loc) · 3.65 KB

activity.md

File metadata and controls

79 lines (59 loc) · 3.65 KB

Follow activity across repositories

Activity is the best place to start when you maintain more than one repository. It combines recent pull request, issue, commit, review, and comment activity in one queue.

Choose the right view

Use Threaded mode to group events under their pull request or issue. This is usually the quieter view because a busy discussion takes one row. Use Flat mode when exact event order matters.

Forge Activity in Threaded mode with events grouped under their pull requests and issues in light mode

Forge Activity in Threaded mode with events grouped under their pull requests and issues in dark mode

Threaded Activity groups each pull request's or issue's events under one row, by repository.

The filters can narrow the queue by:

  • time range and repository
  • pull requests, issues, and default-branch commits
  • event type, author, or text
  • open or closed state
  • draft pull requests
  • human or bot activity

Each GitHub pull request's commit rows show their own original author. Default-branch rows use the author from the most recently synced pull request with the same repository and full SHA. Text search includes those displayed names. Other providers keep their existing author names.

Text search matches every word you type. Put ! or NOT before a word to exclude it: fix NOT alice finds items that match "fix" and hides anything that matches "alice", including items alice opened. Quote a phrase to keep it together, as in !"needs review". The search box highlights ! and NOT when they act as operators. The Pulls, Issues, and Workspaces search boxes read queries the same way.

Choose your starting time range, item and event types, visibility filters, and commit rollup in Settings → Activity. Forge saves these defaults in config.toml and applies them when you open Activity.

Filter choices stay in the Activity URL. You can bookmark a useful queue or send the link to another Kenn Forge user with access to the same repositories. Refreshing preserves the selected time range and Hide closed/merged choice, even when they differ from the defaults in Settings.

Read an item without losing the queue

Select a pull request or issue to open its detail beside Activity. The detail has the same conversation, files, and workspace actions as the dedicated Pulls or Issues view.

Default-branch commit events open a commit diff. Use the file tree to move through the change, then close the detail to return to the same place in the queue.

If the selected item has a workspace, its live shell or agent sessions can sit beside the conversation and files. Resize or collapse the Activity rail when you need more room.

Include local work when it matters

By default, Activity follows provider events. Turn on workspace activity in Settings → Activity when a shell or agent session should move its pull request or issue back into the recent queue.

This setting is useful when local work is the signal you care about. Leave it off when the queue should reflect only what changed at the provider.

Refresh one repository

Use Sync current repository when the selected repository is stale. This updates that repository without scheduling a full sync of every configured repository.

The global repository selector also controls Activity scope. A named repository set is handy for keeping a team, service group, or release train together.