본문으로 건너뛰기

itda

itda is the TDA CLI for managing tda-manager and tda-worker sessions as a team — creating them, listing them, viewing the manager/worker tree, and stopping a manager together with its workers.

For starting and attaching to individual sessions, see isesh.

Commands​

create​

Create a new tda-manager or tda-worker session.

itda create <name> [options]

Options:

  • -w, --workspace <path> - Workspace path (creates a tda-manager)
  • --worker-of <parent> - Parent manager session name (creates a tda-worker)

Examples:

# Create a manager session bound to a workspace
itda create myapp-mgr -w ~/projects/my-app

# Create a worker under an existing manager
itda create myapp-backend --worker-of myapp-mgr

list​

List tda-manager sessions.

itda list [options]

Options:

  • -a, --all - Show all sessions (including inactive)
  • -i, --include <pattern> - Filter sessions matching a pattern (supports * and ? wildcards)
  • -e, --exclude <pattern> - Exclude sessions matching a pattern (supports * and ? wildcards)

Examples:

# List active managers
itda list

# Include inactive sessions
itda list -a

# Only sessions starting with "myapp"
itda list -i 'myapp*'

tree​

Display the manager/worker relationship tree.

itda tree [options]

Options:

  • -a, --all - Show all sessions (including inactive)
  • -i, --include <pattern> - Filter sessions matching a pattern (supports * and ? wildcards)
  • -e, --exclude <pattern> - Exclude sessions matching a pattern (supports * and ? wildcards)

Example:

# Show the full team tree, including inactive sessions
itda tree -a

describe​

Set a description for a session.

itda describe <name> <description>

Example:

itda describe myapp-backend "Backend API and database work"

stop​

Stop a tda-manager session and its workers. Cascade is the default — stopping a manager also stops its workers.

itda stop <manager> [options]

Options:

  • --keep-workers - Stop only the manager, keep its workers running
  • --workers-only - Stop only the workers, keep the manager running
  • --dry-run - Show what would be stopped without stopping anything

Examples:

# Stop the manager and all its workers (default)
itda stop myapp-mgr

# Preview what would be stopped
itda stop myapp-mgr --dry-run

# Stop only the workers, keep the manager
itda stop myapp-mgr --workers-only

See Also​