Manage your runs from your local machine. nextask is a distributed task queue with live log streaming and Git-based source snapshotting for full reproducibility.
curl -fsSL https://raw.githubusercontent.com/TolgaOk/nextask/main/install | bashEnqueue tasks, start workers to process them, monitor their output and status, and organize them with tags.
The example below shows the local CLI in the left pane and a worker running on a remote machine in the right pane.
See nextask <command> --help for all options and nextask --help for all commands.
nextask is agent-ready by design. Install the skills to let agents set up services, deploy workers, and manage tasks:
npx skills add https://github.com/TolgaOk/nextask/skillsParallel monitoring. Monitor logs, check task statuses, and track results without interrupting the agent's workflow.
Resource management. Tasks are serialized through a queue, so agents can enqueue many tasks without overloading workers.
nextask has three main components: the CLI, the persistent database and Git remote, and the potentially distributed workers.
Config files:
~/.config/nextask/global.toml # global defaults
.nextask.toml # per-project
Priority: CLI flags > environment variables >
.nextask.toml>global.toml.
Example config:
[db]
url = "postgres://user@localhost:5432/nextask" # or NEXTASK_DB_URL
[source]
remote = "~/.nextask/source.git" # bare repository used as the Git remote
[worker]
workdir = "/tmp/nextask" # or NEXTASK_WORKER_WORKDIR
heartbeat_interval = "1m" # worker heartbeat frequency
stale_threshold = 3 # missed heartbeats before marking a worker stale
log_flush_lines = 100 # flush after this many lines
log_flush_interval = "500ms" # maximum time between flushes
log_buffer_size = 10000 # log-line channel capacity