Skip to content

v0.1.0

Choose a tag to compare

@alexey-pelykh alexey-pelykh released this 16 Jun 14:48
· 6 commits to main since this release

First stable release. npm install -g ttctl now resolves to a versioned, provenance-signed build (npm provenance + SLSA attestations + CycloneDX SBOMs).

TTCtl is an unofficial, personal-productivity CLI and MCP server for your own Toptal Talent profile — read-heavy access to the data you already see in the portal, plus the handful of write verbs the platform exposes for self-service.

⚠️ Unofficial — personal use only

TTCtl is an independent project, not affiliated with, endorsed by, or sponsored by Toptal. "Toptal" is used nominatively to describe what the tool interoperates with. It operates only against your own profile, using your own session. Please read the README disclaimer and use policy before installing — the README is the authoritative statement of scope and acceptable use.

What's in it

A CLI and an MCP server over the same core:

  • auth — sign in (1Password reference or literal credentials), capture and persist a session bearer, status, sign out
  • profile — basic info, skills, employment, education, certifications, industries, portfolio, visas, résumé, external links, reviews, photo
  • applications — activity items, interview + availability-request detail, interest-request responses
  • engagements — list, breaks, stats
  • jobs — browse, recommended, match-quality, rate-insight, apply funnel, signals
  • timesheets — list, show, submit, update
  • availability — working + allocated hours
  • contracts, payments (payouts, methods, rate, summary), and surveys

The MCP server exposes the same surface to Claude Desktop / Claude Code / Cursor / Windsurf, with file-upload sandboxing and a stdio-only trust model (see SECURITY.md).

Install

npm install -g ttctl@0.1.0
ttctl auth signin

Or run without installing:

npx ttctl@0.1.0 auth signin

Hardened install (skip lifecycle scripts):

npm install -g --ignore-scripts ttctl@0.1.0

Requires Node.js ≥ 22.19.0.


The incremental development history (v0.1.0-rc.1v0.1.0-rc.18) is in CHANGELOG.md.