---
title: "alpacon work-session ls"
description: "List Alpacon work sessions from the CLI. Filter by status such as pending, active, or expired, and by requester type or assigned user to find what you need."
---

> Full documentation index: https://docs.alpacax.com/llms.txt

# alpacon work-session ls

List work sessions and filter by status, requester, or user.

## Usage

`alpacon work-session ls [flags]`

## Key facts

- Lists your active sessions by default.
- Use `--status all --user all` to widen the search.
- `list` is an alias for `ls`.

## Flags

| Flag | Type | Description | Default |
| --- | --- | --- | --- |
| `-h, --help` | `bool` | help for ls | `false` |
| `--requester-type` | `string` | Filter by requester type (user, agent) | — |
| `--status` | `string` | Filter by status (pending, approved, active, completed, rejected, expired, revoked, cancelled); use "all" for any status | `active` |
| `--user` | `string` | Filter by assigned user: default is self, "all" for everyone, or a user uuid | — |
| `--output` | `string` | Output format: table or json | `table` |

## Examples

List my active sessions (default)

```bash
alpacon work-session ls
```

List only active sessions

```bash
alpacon work-session ls --status active
```

List sessions requested by AI agents

```bash
alpacon work-session ls --requester-type agent
```

List everyone's sessions in any status

```bash
alpacon work-session ls --user all --status all
```

Source: https://docs.alpacax.com/reference/cli/work-session/ls/
