tasks.md

 1# Tasks
 2
 3Zed supports ways to spawn (and rerun) commands using its integrated terminal to output the results.
 4
 5Currently, two kinds of tasks are supported, but more will be added in the future.
 6
 7## Static tasks
 8
 9Tasks, defined in a config file (`tasks.json` in the Zed config directory) that do not depend on the current editor or its content.
10
11Config file can be opened with `zed::OpenTasks` action ("zed: open tasks" in the command palette), it will have a configuration example with all options commented.
12
13Every task from that file can be spawned via the task modal, that is opened with `task::Spawn` action ("tasks: spawn" in the command pane).
14
15Last task spawned via that modal can be rerun with `task::Rerun` ("tasks: rerun" in the command palette) command.
16
17## Oneshot tasks
18
19Same task modal opened via `task::Spawn` supports arbitrary bash-like command execution: type a command inside the modal, and use `cmd-enter` to spawn it.
20
21Task modal will persist list of those command for current Zed session, `task::Rerun` will also rerun such tasks if they were the last ones spawned.