> ## Documentation Index > Fetch the complete documentation index at: https://docs.tuneplane.ai/llms.txt > Use this file to discover all available pages before exploring further. # tp job > Follow, inspect and control a running job. ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job logs # follow the latest job tp job status ``` `tp job logs` is the only one that defaults to your most recent job. Everything else takes an id, which `tp job ls` prints. ## Inspect ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job ls # your jobs, including submission history tp job status run-4f2a91 # one job in detail tp job logs # follow the latest, replaying the last 2000 lines tp job logs run-4f2a91 -n 0 # replay the whole history, then follow tp job samples run-4f2a91 # the latest validation round's traces tp job samples run-4f2a91 --vidx 2 -n 10 # the third round, ten samples ``` `--vidx` counts validation rounds and defaults to `-1`, the latest. ## Control ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job stop run-4f2a91 # running to terminated tp job pause run-4f2a91 # stop the process, keep the checkpoint tp job resume run-4f2a91 # back to QUEUED, then relaunched from the checkpoint tp job retry run-4f2a91 # requeue a FAILED or STOPPED job under the same run id tp job delete run-4f2a91 # delete a finished job's record; stop it first if it is running ``` Pause and resume are the same path an administrator's maintenance drain uses, so a job that was paused by a drain resumes without losing progress. See [job states](https://docs.tuneplane.ai/en/concepts/job-lifecycle.md). ## In bulk ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job cancel-all # stop every running or queued job of yours tp job cancel-all -y # skip the confirmation tp job clean # tidy the display records of finished jobs tp job stop-sweep sweep-my-grpo-20260912-101500 # stop a whole sweep ``` `tp job clean` removes display records. To delete the **artifacts** an experiment produced, use [`tp clean`](https://docs.tuneplane.ai/en/cli/clean). ## `tp job` Manage jobs ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job ``` | Command | Description | | - | - | | `tp job cancel-all` | Stop every running or queued job of mine | | `tp job clean` | Clean up the display records of finished jobs | | `tp job delete` | Delete one finished job record | | `tp job logs` | Follow a job's logs | | `tp job ls` | List jobs (including the submission history) | | `tp job pause` | Pause a job, keeping its checkpoint | | `tp job resume` | Resume a paused job | | `tp job retry` | Retry a failed or stopped job | | `tp job samples` | Show one validation round's traces | | `tp job status` | Show a job's status | | `tp job stop` | Stop a job (running -> terminated) | | `tp job stop-sweep` | Stop every active job of a sweep | ### `tp job cancel-all` Stop every running or queued job of mine ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job cancel-all [options] ``` | Option | Description | | - | - | | `--yes`, `-y` | Skip the confirmation | ### `tp job clean` Clean up the display records of finished jobs ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job clean ``` No options beyond `--help`. ### `tp job delete` Delete one finished job record ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job delete ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (**required**) | No options beyond `--help`. ### `tp job logs` Follow a job's logs ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job logs [JOB_ID] [options] ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (see tp job ls); omitted = the latest | | Option | Description | | - | - | | `--tail`, `-n` `` | Replay only the last N log lines before following (default 2000; -n 0 for everything) (default `2000`) | ### `tp job ls` List jobs (including the submission history) ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job ls [options] ``` | Option | Description | | - | - | | `--all` | Show everything (default: the latest 15) | | `--exp` | Only this experiment (full name or last segment) | | `--limit`, `-n` `` | How many to show (ignored with --all) (default `15`) | | `--steps` | Also list the steps the platform ran (export, evaluation, benchmark) | ### `tp job pause` Pause a job, keeping its checkpoint ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job pause ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (**required**) | No options beyond `--help`. ### `tp job resume` Resume a paused job ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job resume ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (**required**) | No options beyond `--help`. ### `tp job retry` Retry a failed or stopped job ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job retry ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (**required**) | No options beyond `--help`. ### `tp job samples` Show one validation round's traces ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job samples [options] ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (see tp job ls) (**required**) | | Option | Description | | - | - | | `--vidx` `` | Validation round index (default -1 = the latest) (default `-1`) | | `--limit`, `-n` `` | How many samples to show (default `6`) | ### `tp job status` Show a job's status ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job status ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (**required**) | No options beyond `--help`. ### `tp job stop` Stop a job (running -> terminated) ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job stop ``` | Argument | Description | | - | - | | `JOB_ID` | Job id (**required**) | No options beyond `--help`. ### `tp job stop-sweep` Stop every active job of a sweep ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}} tp job stop-sweep [options] ``` | Argument | Description | | - | - | | `SWEEP_ID` | The sweep id (printed when tp sweep submits) (**required**) | | Option | Description | | - | - | | `--yes`, `-y` | Skip the confirmation | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.