Trackly CLI

Search and filter job postings. Returns one matching page with title, company, location, structured fields and backend pagination. Use jobFunctions for multiple roles, region for multiple regions, and usStates/caProvinces for geographic detail. Work arrangement is independent from geography and employment type. Unknown sponsorship and non-comparable salary data stay visible with exclude_no and salaryFloorUsd. Never invent industry, specialization, exclusion or literal-search controls; ask when sponsorship intent is ambiguous. If the total is unavailable, returned matching jobs remain valid. Explain countGuidance and use hasMore/pagination; do not retry just for totals.

Get full details for a Trackly job ID returned by search or your saved queue. Missing or closed postings return availability=unavailable with retryable=false and a next step; do not retry that ID. Failures include a category and retry guidance.

Semantic search for companies by name, domain, or keywords.

List all tracked companies with their active job counts.

Get job tracker metrics: total jobs, companies, application status counts.

Read the authenticated user's discovery preferences, including selected and effective job functions, role-specific experience limits and active state, and the discoveryPreferenceRevision required for a safe update.

Atomically replace the complete role-specific experience-limit map. Each value is the highest stated minimum years requirement the user wants for that job function. When Trackly enforcement is active, a job is included when its stated minimum is less than or equal to the limit. Jobs with no stated minimum remain visible. An empty object clears the saved limits. experienceFilterV2Available reports edit capability, not enforcement state. Read discoveryPreferenceRevision with trackly_get_preferences first. If the backend returns a revision conflict, refetch and reconcile with the user; never retry blindly with the newer revision.

Update a job application status (apply, save, or dismiss).

Natural language job search. Describe what you are looking for and the AI parses it into structured filters. Limited to 20 queries per day.

Get a network brief for a Trackly job ID, including company signal, recommended motion, top contact and suggested actions. Missing or closed postings return availability=unavailable with retryable=false; search for another opening. Failures include a category and retry guidance.

Search contacts at a specific company. Returns matching contacts with name, title, email, and status.

Get the full workspace view for a company: active jobs, contacts, hiring managers, coverage gap, and campaign status.

Request that a company be added to Trackly's tracked companies. Use when the user asks about a company that isn't in trackly_search_companies / trackly_list_companies results. Rate-limited to 5 pending requests per user.

Get the deterministic queue of jobs the user already approved by saving as check later. Do not rescore or veto these jobs.

Get the versioned application profile. Sensitive values are returned only after the user opted into encrypted storage.

Get the backend-owned profile schema and onboarding questions. Ask only fields whose state is unknown or needs confirmation.

Update confirmed profile answers with optimistic concurrency. Use global scope only for an explicit always-answer preference. Setting sensitiveStorageConsent=false deletes every stored sensitive and restricted answer (an admin-recoverable archive is kept for 30 days, then purged) and is a two-step action: the first call saves nothing and returns a confirmation challenge; retry with the echoed sensitiveRevocationConfirmToken to proceed.

Start a server-owned no-submit execution. For named or explicitly selected jobs, supply their exact ordered jobIds and set target to their count; no replacement outside that set is allowed. Omit jobIds only for a user-requested recent-first queue target. Consume authoritative progress and nextAction; never fall back to count-only after an exact selection is rejected.

Recover the active Apply execution before recovering or creating a legacy fixed batch.

Read the authoritative execution state, latest current-wave identity, and aggregate progress funnel.

List bounded, value-free exact-member recovery candidates after local context loss. Show the stable job identities to the user and obtain explicit confirmation before recovery; never infer or substitute candidates.

Create an exact-member recovery execution from one confirmed source snapshot. The asserted candidate set is immutable and replacements are forbidden.

List active, nonexpired review-handoff receipts for one execution after context loss. Returns only stable IDs, lifecycle metadata, and member bindings; never browser values, URLs, or local paths.

Claim one exact, unambiguous review-handoff group and classify every member before grouped submission reconciliation. Never use this tool to infer submission or replace success-page evidence or explicit user confirmation.

Fetch a compact, bounded projection for one Apply execution. Request only the current members and profile keys needed for the visible form. The response owns mutability, allowed operations, milestones, lease timing, and progress.

Resume one parked execution member only after the user explicitly requests it. This requires a fresh non-mutating access probe and never authenticates, enters private data, or makes the member mutable by itself.

Approve one exact resume identity for the unchanged original snapshot of an Apply execution. This content approval may be reused across replacement waves, but every run still requires immediate local path, hash, size, and expiration verification before upload.

Advance an execution transactionally for the current browser surface. Returns the immutable proposedWave with frozen accessKnowledge receipts and never opens a browser. Same-key replay returns the same members, order, and rationale. Optional hash-bound accessReviewApproval probes the exact proposed job IDs only after personal deferments are cleared.

Record up to 20 typed, value-free live-probe access classifications, each bound to the exact current batch, member, run, and browser surface. Cache hints and static policy are server-owned. Never include URLs, labels, answers, credentials, OTPs, CAPTCHA text, or page content.

Stop the active execution without changing saved-job state or submitting any application.

List the current user's persistent Apply access deferments. Returns only job, company, or provider scope identities; never URLs, provider names, or chat text.

Persist an explicit user deferment for one Trackly job or its derived company or provider scope. Provider scope applies across companies until explicitly cleared. The server derives company, provider, tenant, origin, and route from jobId; never submit a provider name, URL, or free text.

Clear one explicit user deferment previously listed or created in this session. An exact same-session retry remains idempotent.

Freeze an exact recent-first set of approved Check Later jobs before browser work. New queue entries never change this batch.

Retire a legacy fixed Apply batch after the user explicitly chooses to start fresh. This preserves submitted work, Check Later jobs, and browser tabs; it never submits an application.

Read an existing frozen Apply batch by opaque server pagination. Do not reorder, replace, or rescore members.

Recover the newest unexpired frozen Apply batch for this user after context loss. Returns active=false when no resumable batch exists.

Acquire or renew the optimistic lease required before mutating browser-bound batch members.

Bulk-checkpoint up to 20 browser inspections. Persist only typed actions and redacted fingerprints; never send labels, options, answers, credentials, OTPs, CAPTCHA text, or page content.

Record one explicit content approval for the exact default-resume identity and complete current eligible frozen run set. This does not upload the file; every actual attachment still requires immediate path/hash verification.

Bind an initial or recovered browser surface to an existing frozen member and run. This increments the inspection epoch and returns only the exact backend-stored requisition URL; it never creates a replacement run.

Record value-free current-epoch inventory, missing-tab, close-receipt, post-close absence, or close-failure evidence. closed_verified requires complete controller+user union inventory, an explicit close receipt, and post-close union absence.

Record redacted request, success-page, explicit user-confirmation, or provider-receipt evidence for the current batch member and inspection epoch. Never send page text, receipt identifiers, or external references.

Record a late, expiring truthfulness certification over final answer and wording fingerprints for the exact complete subset that is currently review-ready. Unresolved members remain resumable and do not block ready siblings. This never becomes a profile answer.

Start a legacy single run, or start/recover a frozen member when the complete batch binding is supplied. Recovered members already carrying runId must reuse that run without calling this tool.

Get the authenticated user's aggregate, value-free Apply beta evidence and release gate. The report never returns answers, contact values, addresses, or page text.

Get the current browser workflow, ATS support matrix, integrity rules, and compatible public-skill major version. Fetch at the start of every run and again after maintenance before resuming the existing run.

Report a redacted ATS mechanics or scenario-coverage observation. Never include answer values, addresses, contact data, OTPs, or free-form page content.

Bulk-report up to 20 redacted, batch-bound ATS mechanics or scenario-coverage observations in one request. Never include answer values, addresses, contact data, OTPs, or page content.

Record review readiness or a user-confirmed outcome. Before handoff use literal outcome=review_ready and verify awaiting_manual_submit. Mark submitted with literal outcome=submitted only after a success page or explicit user confirmation.

Bulk-record up to 20 leased, batch-bound review or user-confirmed outcomes. Before handoff every item uses literal outcome=review_ready and every recorded run must return awaiting_manual_submit. After manual confirmation use literal outcome=submitted. Each member returns recorded or a stable conflict without hiding sibling results.

Download the authenticated default resume into a mode-0600 temporary Trackly cache and return exact-file proof for user confirmation before browser upload.

Locally lint a draft before form entry. Returns only a draft hash, length, policy, and stable violation codes. The draft is never sent to Trackly or echoed in the result.

Locally diagnose the exact filesystem path implicated by an I/O failure. Reports measured capacity, inode, mount, quota observability, and write-probe evidence without deleting user files or claiming a global disk cause.

Locally validate a caller-supplied session-finalizer keep set against complete controller and user tab inventories. This pure helper never enumerates, focuses, closes, hands off, or finalizes browser tabs and never sends tab IDs to Trackly.

Locally validate the browser adapter capabilities and ordered, value-free proof stages required to claim one resume attachment. Set capabilities.directFileSet=true only for documented exact-input file setting: semantic_control_discovered -> set_files_succeeded -> user_facing_filename_committed -> parser_fields_rechecked, without chooser events. Otherwise require chooserArming and both chooser stages. This helper does not open a chooser, read a local path, control the browser, or send values to Trackly.

Immediately before attachment, recompute the prepared resume fingerprint, validate its run and expiration, and lock the confirmed file read-only.

Report a capability Trackly does not currently provide. Use structured categories; context is optional and is classified but never stored as raw text.