CLI

Use the CLI when you want a direct terminal interface or when an agent works in your local workspace.

Install the CLI:

npm install -g @talentsourcer/cli

Create a personal access token in TalentSourcer AI:

Open Settings.
Go to Personal Access Tokens.
Create a token with the scopes your workflow needs.
Copy the token once. Do not paste it into agent chat.

Authenticate locally:

talentsourcer auth token set

Verify the connection:

talentsourcer auth status --json

The CLI defaults to the production TalentSourcer AI API. You normally do not need to configure a host.

Common examples

List projects:

talentsourcer projects list --json

Create a project:

talentsourcer projects create \
  --title "Senior Backend Engineer" \
  --company "Acme" \
  --location "Berlin, Germany" \
  --json

List briefings for a project:

talentsourcer briefings list --project <projectId> --json

Update briefing requirements from a JSON file:

talentsourcer briefings update-requirements <briefingId> \
  --from-file ./requirements.json \
  --json

List completed candidate checks:

talentsourcer candidate-checks list \
  --project <projectId> \
  --status Completed \
  --limit 50 \
  --json

Create a shortlist:

talentsourcer shortlists create \
  --project <projectId> \
  --name "Top candidates" \
  --description "Candidates selected for recruiter review" \
  --json

Create a draft campaign from a JSON flow:

talentsourcer campaigns create \
  --project <projectId> \
  --name "Outbound v1" \
  --from-file ./campaign-flow.json \
  --json

Review manual outreach tasks:

talentsourcer outreach-tasks list --scope my --limit 50 --json

Troubleshooting

If the CLI says you are not authenticated, run:

talentsourcer auth token set
talentsourcer auth status --json

If a command returns a permission error, create a new personal access token with the missing scope and authenticate the CLI again.

CLI

Common examples

Troubleshooting

On this page