# runjob

> Keep track of the Run Jobs you've submitted.

The `runjob` commands list, inspect, follow, cancel and delete Run Jobs. To submit one, use [`exec`](/cli/exec).

```bash
featherless-cloud runjob <subcommand> [options]
```

## List Run Jobs

```bash
featherless-cloud runjob list
featherless-cloud runjob list --page 2 --limit 50
```

<table>
<thead>
  <tr>
    <th>
      Option
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --page <n>
      </code>
    </td>
    
    <td>
      Page number. Default 1.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --limit <n>
      </code>
    </td>
    
    <td>
      Run Jobs per page, 1–100. Default 20.
    </td>
  </tr>
</tbody>
</table>

## Show a Run Job

```bash
featherless-cloud runjob get <job-id>
```

Prints its status, compute, image, command, time limit and attempts.

## Read output

```bash
featherless-cloud runjob logs <job-id>
featherless-cloud runjob logs <job-id> --follow
featherless-cloud runjob logs <job-id> --attempt 1
```

<table>
<thead>
  <tr>
    <th>
      Option
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --tail <n>
      </code>
    </td>
    
    <td>
      Recent lines to show, 1–5,000. Default 500.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --head
      </code>
    </td>
    
    <td>
      Show the beginning of the output instead.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --follow
      </code>
    </td>
    
    <td>
      Keep printing until the Run Job ends.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --attempt <n>
      </code>
    </td>
    
    <td>
      Output of an earlier attempt, for a job that started again.
    </td>
  </tr>
</tbody>
</table>

## Cancel a Run Job

```bash
featherless-cloud runjob cancel <job-id>
```

Cancels a waiting or running job.

## Delete a Run Job

```bash
featherless-cloud runjob delete <job-id>
featherless-cloud runjob delete <job-id> --yes
```

Deletes the job and its output, stopping it first if it's running.

<table>
<thead>
  <tr>
    <th>
      Option
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --yes
      </code>
    </td>
    
    <td>
      Skip the confirmation.
    </td>
  </tr>
</tbody>
</table>
