Skip to main content

Configure startup commands

Open a project's Commands view and add the commands the repository needs, such as its development server, test watcher, or log tail. Choose where each command opens according to how it behaves:

  • Main pane (#primary) opens in the main pane.
  • Beside it (#companion) opens beside the primary session.
  • Monitor (#monitor) stays visible in the monitor dock.
  • In the menu (#background) runs without occupying the working panes.
  • Quick run (#quick) is for one-shot work that closes after success. It applies to a command you press, not to the layout.

Put the commands that should open together in the file's Layout section, then use Open layout, or have it open whenever the project does. Saggar stores the shared definitions in .saggar/commands.md, so they clone and review with the repository.

For the file format and CLI form, see Commands, startups, and scheduled tasks.