CLI Changelog
Latest version = 0.105.0
0.105.0
New Features
Live lens board -
tessl code reviewshows a per-lens progress board on stderr while it runs, marking each lens as queued, reviewing, a finding count, failed, or skipped before the reconciling step;--no-progresshides it and--jsonimplies itLift as the eval headline -
tessl eval runprints aLift:line under each completed comparison run, andtessl eval viewleads its summary and each scenario with the lift in percentage points, noting how many unscored results were excludedOrganization-level project discovery -
tessl project list,tessl project link, andtessl project creatediscover projects across your whole organization, with--org(orTESSL_ORG) to pick the organization,--workspacefor single-workspace behavior, andtessl project link --pathto match a package project by its repository subpath
Improvements
One Tessl Code Review plugin - the CLI embeds
tessl/code-review0.2.0, which now carries the setup, lens-authoring, and review-response skills alongside the four lenses; the default lenses are repinned to 0.2.0 with unchanged content, and a project that still declarestessl/code-review-setuportessl/code-review-lens-creatorintessl.jsonkeeps using it until it switchesCode review at splash - the "Review code changes" onboarding workflow installs
tessl/code-review, sets up review on every pull request, and suggests one custom lens the default lenses would miss, without writing itGrouped review summary -
tessl code reviewends with a versioned header, a verdict line with must-fix and suggestion counts, findings grouped into must fix and suggestions sorted by severity, and the exact publish command; under--jsonthe same summary goes to stderr so CI logs carry itEval reuse made visible -
tessl eval runandtessl eval viewprint how many results were reused from previous runs beside the cost line, so a fast, cheap run no longer reads as staletessl project list --jsonreports the organization - the output carries a top-levelorginstead ofworkspaceunless--workspaceorTESSL_WORKSPACEpins one
Bug Fixes
tessl code reviewagainst a caller-supplied LLM endpoint with a model-scoped key no longer fails during reconciliation, because the pinned supervisor model is sent by its bare nametessl eval viewfloors score percentages instead of rounding them, so the table, averages, and lift agreeThe splash screen's workflow picker moves one step per arrow key press on Kitty-protocol terminals such as Ghostty, Kitty, and WezTerm, where the key release was counted as a second press; a held arrow still scrolls smoothly
0.104.0
New Features
Eval cost shown before you spend -
tessl eval runprints an estimated cost line and your org's daily eval usage before the run starts, including with-yEval cost in machine output -
tessl eval run --jsongainsestimatedCreditsandquota, andtessl eval view --jsongainsmeta.creditsfor the settled run cost
Improvements
Review action beside severity - every published Code Review finding now shows
Requires changesorAdvisorynext to its severity, along with why an advisory finding is advisory: low confidence, pre-existing, unclear relationship, or the review modeRun cost reported in CI - the post-run credit cost line is no longer suppressed on non-interactive streams, so CI and piped runs see the spend
Bug Fixes
tessl api --input -and-F key=@-now read stdin from a redirected file or heredoc, not just a pipe; both refuse an empty stdin or a bare terminal with an error instead of sending no body
0.103.0
New Features
Scheduled runs -
tessl scheduleis now available. You can use it to automatically run skills on a periodic schedule.Environment management -
tessl environmentcan be used to manage environments fortessl scheduleandtessl launch skill --cloudAntigravity support - first-class support for the Antigravity CLI (
agy) and the Antigravity IDE, alongside the existing Gemini integrationtessl eval run --wait- polls the run to completion and exits non-zero when all runs fail;--jsonalways submits without waiting, and a run that outlives the poll window exits 0tessl api-key delete --yes- skips the confirmation prompt, with-yas the short form
Improvements
Agent step lines - each tool call in an interactive
tessl agentsession renders as one status line naming the step and its result, withctrl+oto expand the full outputExpand-all hint - the agent header now advertises the collapse and expand-all shortcut, resolved from the effective keybinding
Activity footer - the footer names the running step, shows an elapsed timer, and keeps the known-total count, then leaves a one-line result carrying the total duration
Permission prompts - the command, target, or path appears on its own indented line, long commands are middle-truncated so the tail stays visible, and bash prompts carry a Why line when the agent states its intent
Code Review finding assessment - the supervisor now assesses likelihood, confidence, and relationship to the change alongside severity, and a deterministic Strict, Standard, or Relaxed policy decides what blocks
Code Review severity table - rows are ordered Critical, Major, Minor, then Nit rather than by insertion order
Code Review round notice - rounds after the first carry a collapsed "About this review" block noting the findings are AI-generated, with a link to the guidance
Code Review thread links - a finding carried forward now links the thread that is carrying it
Skill review phases - the bundled
review-skills-in-repositoryskill splits into a Discover phase that reports and stops, and a Review phase entered only when you opt inSkill review scope - after discovery the skill offers one skill, a prioritized batch, or every discovered skill, each with an expected duration and credit cost, replacing a silent 20-skill cap
Skill review output - the review leads with a ranked list of every reviewed skill, one line each, with per-skill detail on request and coverage counts below it
Skill discovery - discovery runs as a deterministic bundled script rather than an agent file-system walk
Clearer command briefs -
tessl project,tessl agent,tessl outdated, andtessl updatenow describe what they doClearer skill name errors - an invalid skill name names the specific problem and suggests a corrected name
Eval default model notice - the notice no longer names a model and points at
tessl eval run --list-agents, since the default is declared per regionProject mismatch -
tessl installblocks with the relink command when the backend already has a project for this directory, andtessl initwarns before creating a second one
Bug Fixes
tessl eval viewexits 1 for a failed run, andtessl eval runaborts with exit 1 when the scenario count exceeds the guardnpm install tessl@Xinstalls version X instead of whatever the release channel currently advertisesThe agent session no longer clears scrollback and snaps to the top while streaming, so a permission prompt stays reachable
Code Review keeps successful lens results when a sibling lens fails, and states the reduced coverage instead of discarding the whole review
Code Review republishes a moved finding at its current anchor and links the earlier occurrence, instead of leaving the only comment on stale code
Code Review includes verified optional findings in first and explicitly requested full reviews
tessl workspace deletedistinguishes a deleted workspace from one emptied in place, and names the plugins to remove when they block deletiontessl scenario generateno longer blames plugin content or the quality verifier for a zero-scenario result, and reports a timeout distinctly from a failuretessl scenario downloaddefaults to the plugin root when run inside a pluginFixing path handling bugs in
tessl installandtessl initon WindowsThe agent onboarding editor keeps a custom editor factory and honors the Kitty keyboard protocol
An ambient
WORKOS_CLIENT_IDno longer overrides CLI auth
0.102.0
New Features
tessl eval lint- the scenario lint command now shows intessl eval --help, andtessl scenario downloadprints a hint that downloaded scenario files can be edited by hand and validated with itLaunch activity for pending runs -
tessl launch skill --cloud --wait,tessl launch view, andtessl launch listnow show a pending run's phase and last progress time; retrying and recovering read distinctly and are never shown as failed
Improvements
Adaptive review effort -
tessl code reviewnow defaults to adaptive effort, picking the right depth for each review;--effortwith low, medium, or high stays fixedCode Review finding quality - findings are checked more rigorously before they are surfaced, and severity now better reflects the real consequence of each finding
MCP server status - configured MCP servers now read as ready and connect automatically on first tool use; the footer, status output, and MCP panel share one state model with clearer sign-in guidance
Plugin terminology - user-facing copy now consistently says plugin and plugins; the migrate commands for legacy tile content are unchanged
Bug Fixes
Code Review now replies on an existing review thread when a re-review changes its conclusion, instead of leaving its earlier answer as the last word while the check stays red
tessl loginnow lets a user who belongs to more than one organization choose which one to sign in to on the approve page, instead of failing for members of an SSO-enforced organization with a second membershipSpinners are suppressed when stdout is not a TTY, keeping piped output,
--jsonmode, and agent contexts cleantessl cli updatenow shows a clear error pointing at--channelwhen a release channel name is passed as--targetEval runs that outlive the CLI's poll window are now reported as timed out instead of failed, so a run that completes server-side no longer triggers a false "All eval runs failed"
The workflow hint in
tessl agentnow steps aside while another UI such as the settings menu owns the prompt row, and no longer appears on--continueor--resume
0.101.0
New Features
tessl login- loopback is now the default transport. Plaintessl loginuses the loopback authorization-code and PKCE flow, and the device grant stays available with--device.Local GitHub App minting - when
TESSL_GITHUB_APP_IDandTESSL_GITHUB_APP_PRIVATE_KEYare both set,tessl github token,tessl github setup-authand the auto-refresh sidecar mint installation tokens directly as that App, so its own bot identity lands on commits and pull requests. With either variable absent, behavior is unchanged.Guided first run - a new signed-in user is handed off from the web onboarding into
tessl agentwith the review-skills workflow, with in-editor hints for the next action.Context and Findings - the embedded CLI skill now works in terms of Context and Findings instead of a skill inventory, and points at the current per-workspace Context and per-org Findings endpoints.
Improvements
tessl code review- a finding states what is broken and what a fix has to achieve instead of prescribing a specific fix, and a review no longer blocks on code outside the diff.A deliberate, explained reversal of an earlier fix is read as a decline rather than a regression, so the same concern is not raised again.
A finding is reposted on a silenced thread only when it requests changes, so an optional suggestion is no longer republished every round.
Local-mint failures show GitHub's own error message without
--verbose, and report the measured local-versus-GitHub clock difference when the two disagree.The
--modeland--scorer-modelbriefs ontessl eval runshow current model names.
Bug Fixes
tessl loginreports the reason for a WorkOS authentication challenge, such as organization selection or email verification, instead of a bare status code.tessl login --loopbackalways runs the loopback transport instead of silently rerouting to the device grant on a host that looks remote. An automatic fallback prints why it happened and which flag overrides it.Skill symlinks resolve the physical parent directory before computing their target, so links no longer dangle when an intermediate directory is itself a symlink.
tessl launch skillno longer reports a watch timeout as a launch failure. It stops watching, exits 0, and prints atessl launch view <id>command.tessl eval runrefuses a run started from inside a plugin'sevals/directory before any credits are spent, rather than silently running baseline only with no plugin context.Onboarding hints release the arrow keys when another component, such as the model picker, takes focus.
The
[PostHog] Timeout while shutting down PostHogwarning is no longer printed on exit.
0.100.0
New Features
tessl project list- lists the projects in a workspace with each one's name, ID and source. The workspace is resolved from--workspace,TESSL_WORKSPACE, the project linked intessl.json, or a picker.--jsonemits a structured list and never promptsA machine-readable verify report -
tessl change verify --report-json <path>writes its JSON report to a file, so CI can consume verifier findings without a second run. Stdout is untouched and--githubannotations still work alongside it. The report now also carries each verifier's stableid, in both--jsonand--report-jsonCloud launch progress -
tessl launch skill --cloud --waitshows live progress on the spinner while the run is in flight, instead of a static message.--jsonand--no-waitare unaffected
Improvements
Working with this review - the first Tessl Code Review on a pull request now publishes a collapsed section telling the reader that the findings are AI-generated and not authoritative, which answer to give on each thread (addressed, refuted, or declined), that reviews are incremental and what a later round therefore withholds, and that lenses are configurable and glob-scoped. It is published on the first review only, so a later round does not push the findings further down.
tessl code review run -hsays the same thingsSettled threads close themselves - a Tessl Code Review round now resolves the threads whose finding the current head fixes, after replying on them, so what stays open on a pull request is what still needs someone. A refuted or declined finding's thread stays open for the author to close
One closing instruction on every round - every published review round now closes with the same line: mention
@tessl-code-reviewto run another review
Bug Fixes
Repository flags accept a GitHub URL -
tessl github setup-auth --repoandtessl github token --repoaccept a full GitHub URL as well as anowner/nameslug. HTTPS, scheme-lessgithub.com/owner/name, and SSH forms all resolve to the same repository, and a non-GitHub host is rejected with the value echoed backA full review says it was full - a full Tessl Code Review no longer closes by claiming it narrowed itself. A full round now states that the whole change was read and every new finding raised whatever its severity, and keeps the contrast with an ordinary round
A live finding is not left collapsed - a re-review that concludes an earlier finding still applies now reopens that finding's resolved thread, so the update is not left where tooling and readers skip it. A thread whose finding was answered as addressed, refuted, or declined stays resolved
A finding reaches its reader when a thread cannot reopen - the finding is published as its own comment instead of being left where no reader reaches it. A GitHub Actions token may reply to a review thread but may not unresolve one, so the review now asks per thread rather than assuming
Mentions are matched case-insensitively - a mention of
@tessl-code-reviewthat differs only in case, such as@Tessl-Code-Review approve, is now read as a mention. An approval request spelled that way was previously answered with an ordinary reviewVerify reaches allowlisted dot-directories -
tessl change verifydiscovers files in repository-root dot-directories that a verifier's include globs name explicitly, so an include such as.github/code-review/*.mjsmatches instead of silently matching nothing. Only allowlisted repository-tooling directories are opened, and only at the repository root
0.99.0
New Features
Named approver logins -
tessl code review --approver <login>names comment authors permitted to request an approval, beyond the repository owners, members and collaborators who always may. The flag is repeatable, logins are compared case-insensitively, and a bot login is matched exactly as the event payload spells it,[bot]suffix included. GitHub reports every app comment with associationNONE, so before this no bot could pass the guardA refused approval request no longer runs a review - asking to approve without permission settles as skipped in under a second, rather than spending a full review to answer the opposite of what was asked. The message leads with what was refused and names the route back: approving is limited to owners, members and collaborators, plus any login passed with
--approverFull review requests - a commenter who may approve can ask for a full review instead of another round. Its specialists then see the whole change rather than only the commits since the last reviewed head, and a low-severity finding no earlier round raised is raised. Prior findings still reconcile on their existing threads. A request from an author the repository does not trust to approve runs the ordinary round rather than being refused
A change-requirement threshold in Code Review profiles - a repository YAML profile sets
requestChangesAt, the severity at which a finding starts requesting changes, so a team adopting Code Review on a large existing codebase can gate on criticals alone while a repository with a strict main branch holds minors on every round. It is a profile key rather than a flag, so no caller can weaken the gate without changing the profile the repository committed. The default is nowmajoron every round, which means a minor no longer requests changes on a first reviewMachine-readable output on list and view commands -
--jsonontessl whoami,tessl config get,tessl config list,tessl org list,tessl plugin info,tessl workspace listandtessl workspace list-membersprints one JSON document. Every--jsoncommand now writes one pretty-printed document to stdout and routes hints, progress, warnings and errors to stderr, so stdout stays parseableSign in with a local browser redirect -
tessl login --loopbacksigns in with a loopback authorization code and PKCE, so the browser hands the session back to the terminal without a code to type. The device code flow stays the default and is unchanged, and--loopbackfalls back to it when the browser is not on this machine or the loopback port cannot bindFind work to automate - a fourth onboarding workflow in
tessl agentlooks for what you do repeatedly that could run itself. It returns at most five ranked candidates, each with its evidence, its expected value, a suggested trigger and an implementation direction, and expands one on request
Improvements
Whoami describes the API key -
tessl whoamiin a session authenticated with an API key now shows the current key in use (masked), its scope, its id, and the organization and workspace it belongs toFindings below the threshold on a later round - a re-review no longer raises a fresh finding below the change-requirement threshold, and a finding an earlier round raised stays on its thread. An approving review that carries findings now states how many of them are optional, so open findings under an approved verdict are not read as blockers
Guidance routing - broad questions about Code Review, Risk and Verify reach the harness design skill, while an explicit request to author a review lens still reaches the lens creator
Code Review setup knows the new profile keys - the bundled
tessl/code-review-setupmoves to 0.3.0, so a project that does not declare the plugin itself gets a setup skill that covers the change-requirement threshold and who may ask the reviewer to approveA rejected CLI version says how to upgrade - when the backend refuses a CLI as too old, the CLI prints the reason it was given along with how to upgrade, rather than a generic failure. A request that never reaches the backend at all is now reported as a network failure rather than as an API rejection
Clearer guidance outside a project - a command run where no Tessl project can be found says to run
tessl initfrom the project root, instead of describing what a project is
Bug Fixes
Spinner frames stay out of JSON output -
tessl review fixandtessl review run qualitystop the spinner before printing the--jsonstatus payload on the timeout, failed and cancelled pathsCode Review resolves the repository's default branch - the base is read from
origin/HEAD, falling back to a probe fororigin/mainthenorigin/master, instead of assumingorigin/main. A repository whose trunk is named something else is told to pass--baserather than failing on a ref that does not exist, and an explicit--basestill wins outrightAn empty change is skipped rather than approved - a local review of a clean, up-to-date checkout returns a skipped result carrying
No changes to review.before any model call, instead of running every lens and publishingChanges approvedover a change that does not existEval runs report what happened -
tessl eval runretries a run that is momentarily missing from the poll endpoint just after it was created, rather than treating it as terminal, so completed runs no longer reportAll eval runs failed. When every run really does fail the command exits non-zero, so a pipeline wrapping it sees the failure
0.98.0
New Features
Publish a Code Review from the CLI -
tessl code review --publish <comment|verdict>posts the completed review to the pull request it reviewed as one native GitHub review: a summary body, an inline comment on each finding GitHub can anchor to a changed line, and a reply on each earlier finding's thread the round reconciled.commentstates no position on the change, whileverdictcarries the review's own conclusion, approving when nothing requires changes and requesting changes otherwise. With--json, the result carries apublicationreceipt naming what was publishedReasoning effort is supported configuration -
--effort low,mediumorhighsets how hard each review lens thinks. A YAML profile can seteffortfor every lens, and any single lens can set its own to think harder or less hard than the rest, so depth is spent where it pays. A lens without one uses the profile's, with neither the model applies its own default, and--effortoverrides bothIgnore globs in Code Review profiles - a YAML profile takes a top-level
ignorelist of repository-relative POSIX globs bounding which paths any lens reviews, so generated code, lockfiles, snapshots and vendored directories are excluded once instead of negated inside every lensAn inline workflow hint replaces the onboarding splash -
tessl agentopens with a few lines above the prompt rather than a full-screen welcome. Either arrow key opens the list, selecting a workflow fills the prompt with it ready to send, and/getting-startedreopens the listReview my skills - a new onboarding workflow that reviews every skill in the repository. It discovers them, lints them deterministically, reviews each against seven dimensions, and returns a ranked plan tied to evidence. It changes no files, and offers
tessl review fixas an opt-in follow-upLearn from PR feedback needs no input - the workflow defaults to the last two weeks instead of asking for a pull request number or a time period, states up front that it changes no files, and returns a ranked, capped set of improvements with its coverage limits named
Workspace and organization environment variables -
TESSL_WORKSPACEandTESSL_ORGset the workspace and organization for commands that take--workspaceand--org, so a script does not repeat the flag on every call. An explicit flag always wins, and a project.envfile cannot set either oneGlobal installs follow organization policy - globally installed managed requirements converge on the organization's install policy whenever the CLI contacts the backend, not only on an explicit
tessl install -g. Security thresholds, minimum release age and source restrictions all still apply, and only policy-owned content is removed
Improvements
Clearer failure messages - installing over Git, self-update, sign-in and eval artifact uploads report failures written for the reader, rather than passing transport wording such as
HTTP 404through to the terminalHelp reads for its audience -
tessl --helpprints plain text for a person, with usage, grouped commands and flags. The Markdown reference is served only to recognized agent callers, and covers the top level, a group and a leaf alikeCode Review setup - the bundled
tessl/code-review-setupmoves to 0.2.0. The setup skill documents the profileignorelist, and the workflows it writes subscribe to pull request review comments, so a mention left on the diff starts a review. Who may request one moves to anallowed-associationsinput rather than a condition the workflow implements itself, and theuses:line references the Action's major tag instead of a commit resolved at setup time, so a repository picks up fixes without editing its workflow
Bug Fixes
Conceded findings settle - a finding the author agrees is real but defers to tracked follow-up work now reconciles as declined, instead of resurfacing as remaining on every later round
Verify separates errors from failures -
tessl change verifyreports a target it could not judge, such as a base ref it cannot resolve, as a distincterroroutcome rather than a verifier failure. Those targets are listed under "Could Not Be Verified", left out of the failure breakdown, annotated as notices, and still exit non-zeroLaunch reports the agent's own outcome -
tessl launch skill --cloud --waitexits non-zero when the workflow completes but the agent reported a failure, andtessl launch viewrenders the agent-reported outcome for completed runs
0.97.0
New Features
Repository YAML profiles -
tessl code review --profile <path>now accepts a repository YAML profile as well as the built-instandardprofile. A profile routes lenses with ordered repository-relative globs, and each specialist's prompt and read-only diff tools are scoped to the paths its lens matched. The path must end in.ymlor.yamlApproval commands - a trusted repository owner, organization member, or collaborator can mention
@tessl-code-reviewwith an explicit instruction to approve the pull request. Code Review returns an approved result without running specialist lenses. Ordinary review requests, ambiguous wording, and classification failures continue through a normal reviewAgent-facing help - a bare
tessl, or an explicit-h, from a recognized agent now prints a Markdown description of Tessl and how to drive it, generated from the command registry. Claude Code, Cursor, Codex, and Gemini are detected without configurationReadiness reporting -
tessl doctor --jsonand the MCPstatustool both return areadinessfield with astate, machine-readableblockers, and an orderednextActionslist. One shared function computes the field so the two surfaces return consistent guidance. Existing fields anddoctorterminal output are unchangedAPI key listings as JSON -
tessl api-key list --jsonprints a machine-readable listing, walks every page so a truncated result cannot appear complete, and includes each key's roleAPI key expiry notice -
tessl api-key createprints the key's expiry date and days remaining to stderr. A key piped directly into a secret store still reports its 30-day lifetime while stdout stays cleanrotate-ci-key- a new bundled skill reads your pipeline to find which secret suppliesTESSL_TOKEN, selects a rotation tier based on its access, presents a plan naming the source of each fact, and waits for approval before changing a live credentialAntigravity skills - a global install now also symlinks skills into
~/.gemini/config/skills/, where Antigravity, Antigravity IDE, and Antigravity CLI look. The existing.agents/skillspath is unchanged
Improvements
Lens limit - Code Review accepts up to 8 lenses, up from 5. The lenses active for the current change are resolved before the limit applies, so lenses whose globs match nothing do not count against it
Error routing - 9 more precondition failures name what was found and return the command that resolves it. This covers linting a directory with a
SKILL.mdbut no manifest, an unlinkedtessl.json, an invalid package name, an empty scenario directory, a missing fix-run bundle, and the deprecated skill review path. Raw HTTP statuses no longer reach the userSetup handoff -
tessl initnow wires agent context (RULES.mdandAGENTS.md) even when no plugins are installed, so an agent has context before anything is installed.tessl loginresumes the interrupted setup step when there is one, and otherwise points to the first unblocked step. Every MCP tool that requires authentication now says so in its descriptionRejected key guidance - a rejected API key now reports where the detected CI provider keeps pipeline secrets and which of its CLIs edits them, across 12 providers with a generic fallback. On GitHub Actions, the failure is attached to the workflow file as an annotation and appended to the run summary. Outside CI, the guidance points to a
TESSL_TOKENthat may be shadowing a healthy session and should be unset instead of rotatedtessl inventory importscan scope - scan scope is read from the integration scan policy configured on the organization integration page and enforced when data is persisted. The command no longer fetches a server-side exclusion list to pre-filter the scan. Only--ignore-reponarrows a run locallyLens authoring - the bundled
tessl/code-review-lens-creatormoves to 0.1.1. The lens-authoring skill now directs its reference reads explicitly, and its evaluation tasks no longer prescribe the answer they scoreCode Review setup - the bundled
tessl/code-review-setupmoves to 0.1.5. The setup skill now covers YAML profiles for CLI and Action runs, including lens routing, path scoping, the lens limit, local reference safety, and what happens when no lens matches. It also configures the Action with a repository-relative profile path
Bug Fixes
Login link - the URL printed when the CLI cannot open a browser now always carries its verification URI. Production builds previously omitted it, leaving SSH and development-container logins with a link the capture page could not use
MCP shutdown - Ctrl-C no longer crashes the MCP server, and its capability warning is gone
Supervision context - a live review refreshes the pull-request conversation after the specialists finish and immediately before supervision, so a reply posted while the review was running is taken into account. The run fails closed if the refresh fails or the base or head moves during the review
Reviews with no matching lens - a review whose profile matches none of the changed paths returns an explicit skipped result without running a model, instead of completing in a way that reads as approval
Truncation reporting - prompt truncation is reported whenever any specialist lens truncates, rather than depending on which parallel lens finished last
Review cancellation - the every-commit workflow template no longer lets a comment on a pull request under review cancel the review in progress, and a push to a draft can no longer cancel a requested review. Cancellation is limited to a non-draft
synchronizeevent. Workflows generated before this release keep their original template until regenerated
0.96.0
New Features
Tessl Code Review (Beta) -
tessl code reviewnow appears in the CLI help and runs a multi-lens review over a code change. With no flags it auto-selects the current pull request in a supported CI environment, or otherwise the complete local change;--pr <ref>reviews a pull request, and--base/--headreview an explicit Git range with no pull request requiredCode Review setup through Tessl Agent - the tessl/code-review-setup plugin now ships embedded in the CLI, so asking Tessl Agent to set up Code Review installs the review workflow directly; the embedded guidance for the older change review flow was removed
Lens authoring through Tessl Agent - the tessl/code-review-lens-creator plugin also ships embedded, so asking Tessl Agent to create a review lens scaffolds one without an install
Improvements
Change review hidden from help -
tessl change reviewno longer appears in help output; Tessl Code Review supersedes it. The command keeps working for existing callersFirst run points at setup - the first CLI invocation shows a one-time hint pointing at
tessl init, and the install scripts hand off with the same guidance. The hint is skipped in CI and on invocations requesting--jsonError messages direct the user to the command that resolves them - user-facing errors now route to the command that fixes the reported state, instead of only describing the failure. Additionally, every missing-argument error states which argument was missing
Credit refusals are legible mid-run - when credits run out in the middle of a run, commands surface a clear credit message across CLI and MCP surfaces instead of a generic failure
Skill review MCP tools state their scope - the review_run, review_fix, and review_view MCP tool descriptions now say they review skills, and point to
tessl code reviewfor reviewing code changesMCP tool descriptions name neighboring workflows - the status MCP tool description names the adjacent workflows to run next, so an agent picks the following tool without guessing
Skill publish validation - publish validation reports every independently detectable problem in one pass, and skill validation messages use Tessl terms instead of raw schema output
Bug Fixes
Install with a broken project link -
tessl installno longer fails when tessl.json links to a project that cannot be resolved, and errors in that state no longer suggest creating a new projectOrganization selection in workspace create -
tessl workspace createresolves the owning organization before creating the workspace: the new--orgflag takes an organization name or id, and membership in several organizations prompts for a choiceScenario generation from the current directory - the source argument to
tessl scenario generateis now optional and defaults to the current working directoryAPI token identity -
tessl doctor,tessl init, andtessl mcp startno longer print a fabricated api-key@tessl.io email when authenticated with a TESSL_TOKEN API key; they identify the session by the masked token insteadCorrupt tessl.json errors name the file - a JSON parse failure while reading tessl.json now names tessl.json in the error message
Live documentation links -
tessl skill newandtessl plugin newprint working docs.tessl.io links in their next-step guidanceNo memory writes on read-only turns - Tessl Agent no longer creates or updates .tessl/memory files during turns that make no changes
0.95.0
New Features
Delete an API key by name -
tessl api-key delete <name-or-id>accepts either the key name or its ID, matching the pattern already used elsewhere. Interactive selection still works when no argument is givenSkill removal guidance - asking to unpublish, archive or delete a skill now explains that skills are published inside a plugin and lists the three real removal paths, and
tessl skill --helpcarries the same tipUncollected file warnings in review -
tessl review runandtessl review fixnow name the skill files that were not sent to the reviewer, so content that scored low because it never reached the judge is visibleOut-of-workspace path warnings -
tessl scenario viewflags generated scenarios whose task or criteria reference a home-directory or absolute path, which can never score above zero because the grader only sees the workspace
Improvements
Credit warnings on stderr - credit warnings print to stderr instead of stdout, so they no longer sit inside a command's own output.
TESSL_CREDIT_WARNING_STREAMacceptsoff,stderrorstdoutto override the choiceUpgrade path in the agent credit footer - the out-of-credits and over-limit states now point at
/usage, where the balance and the upgrade link livePricing links - credit and upgrade calls to action point at
/pricingCredit checks on the MCP surface - the MCP server now runs the same credit preflight as the CLI, closing a path where a blocked organization could still spend credits
Score composition in review output - review results show how a score was composed, per judge, rather than only a final number
Organization default model for agent sessions -
tessl agentpicks up an organization's configured session model when no--modelflag and no persisted default are setReview hands off to fix - after a quality review,
tessl review runpoints attessl review fixas the next step when the review found something to act on. The MCPreview_viewtool carries the same signal as anextStepfieldFix runs stop at a reachable score - the default fix threshold drops from 100 to 90, so a run can finish early instead of burning every improve iteration on a target a review almost never hits. The MCP surface no longer holds its own defaults and reports the config the server resolved
Bug Fixes
Review scores render against the rubric's own scale instead of a hardcoded denominator of 3, so a 1 to 5 rubric no longer reports the wrong total
tessl skill review --jsoncarries the deprecation notice in its payload, and the post-apply hint points attessl review runinstead of the deprecated commandA logged-out global install of registry content is refused when the global context is managed by an organization policy, closing a path where logging out skipped the organization's managed requirements
tessl install -glabels the resolved policy scopeorg:instead of mislabeling itworkspace:Auto permission mode no longer fails at startup for organizations whose model catalog omits
gpt-5.4-mini. The classifier falls back to the resolved session modelReasoning models in the
gpt-5.6family route through the OpenAI Responses API, fixing a gateway 400 when a request carried both a function tool and a reasoning effortSkill inventory upload accepts
internalas a repository visibility, so GitHub Enterprise organization-internal repositories are no longer rejected
0.94.0
New Features
Credit usage meter -
tessl org usageshows your organization's plan, credits used against the allowance, and when the current window started. Pass--orgto name an organization,--jsonfor the raw credit account/usageand/costin the agent -/usageshows the same meter without leaving the session,/costshows what the session has cost in credits with the token counts underneath, and acredits: N leftsegment on the footer refreshes each turnCommands report what a run cost - every command that waits for a run prints the credits it consumed once billing settles, and
... viewcommands report the cost of the run they inspect. The figure comes from the server, so it matches what you are billedCredit guardrails on billable commands - a one-line notice when you are over your allowance but still allowed to proceed, and a hard stop with an upgrade link when you are not. Both are suppressed under
--jsonso structured output stays parseableScoped reviews - new repeatable
--pathflag ontessl change reviewrestricts the review to files matching a pathspec
Improvements
Security grades read Tessl's own levels -
tessl search,tessl tile infoand the security review output now render the Tessl security level and per-finding severity. A clean result reads "Passed", an unscanned one reads "N/A", low-severity findings group into their own section below higher severities, and an unrecognized level renders as-is instead of failing.--jsonkeeps the previous fields alongside the new onesEval fixtures are bounded to the run -
tessl eval runand publish-time evals now refuse scenario fixtures and packed symlinks that resolve outside the run's repository or scenarios boundary, so an eval can no longer archive files from elsewhere on the machine.tessl eval lintreports the same. Out-of-boundary directory fixtures and symlinks are opt-in viatessl eval run --allow-unsafe-fixture-paths, or--allow-unsafe-eval-fixture-pathsontessl skill publishandtessl plugin publish. A scenarioincludemust always resolve inside its own scenario, with no overrideA project's
.envcan no longer redirect the CLI's own state -TESSL_GLOBAL_DIR,TESSL_BINARY_BASE_URL,TESSL_AUTO_UPDATE_INTERVAL_MINUTESandTESSL_DISABLE_UPDATEare ignored when they come from a.envfile in the working directory. Values set in your shell are unaffectedWorkspace resolved from a plugin manifest - working inside a plugin directory that has
.tessl-plugin/plugin.jsonbut notessl.jsonno longer prompts for--workspace; the workspace is read from the plugin nameDeclared skills scanned as real files -
tessl inventory importnow scans skills declared intile.json/plugin.jsonthe same way it scans any otherSKILL.mdin the repository, so they carry their body and frontmatter instead of being recorded as bare references. Their names now come from frontmatter (or the containing directory) rather than being prefixed with the plugin name, and a declared skill whose file is missing from the scanned tree is no longer recorded at allworkspace_listreports what you can do - the MCP tool now returnsallowedActionsper workspace, so a caller can filter to the workspaces it has permission to act on before trying
Bug Fixes
Failing commands print one error line. Previously the same message appeared twice, with two different cross glyphs
tessl change verify --recursive --githubnow emits GitHub Actions annotations for every root. Warning-level findings from a recursive run previously only appeared in the raw job logOut-of-credits and other expected failures from the
review_run,review_fixanduninstallMCP tools are reported as errors rather than crashesThe MCP
workspace_list_memberstool explains that your role cannot view members, instead of failing genericallyA cached version entry dated in the future is treated as expired, so it can no longer suppress the update check indefinitely
The path-containment check no longer misreads directory names that begin with two dots, and anchors relative targets on the boundary root
0.93.0
New Features
Severity grading on review findings -
tessl change reviewnow grades every finding nit / minor / major / critical by default; pass--no-gradeto turn it offFinding attribution - each
tessl change reviewfinding names the reviewer skill that produced itExplicit review range - new
--headflag ontessl change reviewto review a specific commit range instead of the inferred onePublish-access filter - new
--has-publish-accessflag ontessl workspace listto show only workspaces you can publish toPlugin Creator in Tessl Agent - the agent now ships with the Plugin Creator skills for authoring plugins
Improvements
Symlink guard for MCP config - the CLI warns and asks for confirmation before writing MCP configuration through a symlink that points outside your project
Local-execution notice - installing a plugin that ships an MCP command which runs on your machine now tells you at install time
Global installs respect
--agent- the--agentscope is honored when installing context globallyCLAUDE_CONFIG_DIRsupport - installing global Claude Code context now honorsCLAUDE_CONFIG_DIRClearer permission prompt - the session-scope option in the agent permission prompt has a clearer label
Clearer MCP review tools -
review_run,review_view, andreview_fixdescribe what they do and what to expectKeys revoked on logout -
tessl logoutrevokes the device's LLM keys
Bug Fixes
Fixed concurrent auto-updates leaving behind a dangling symlink
Fixed a race when two installs ran at once by staging npm installer downloads
tessl change verifynow fetches the diff base itself in shallow and CI checkouts instead of failingInstall sync no longer fails when a skill entry is missing from the manifest
Search results now render when ranking data is unavailable
Review scores now use the rubric scale reported by the API instead of assuming a fixed scale
Removals
tessl context libraryand itsquery_library_docsMCP tool have been removed. They were deprecated and have no replacement.
0.92.0
New Features
Hooks in plugins - Plugins can now declare cross-agent hooks via
hooks/nativeHooksinplugin.json. See the plugin configuration docs.
Improvements
Signed release verification - CLI installation and self-update now verify against a cryptographically signed release manifest before extraction.
0.91.0
New Features
Agent-readiness report - run
/agent-readyin thetesslagent to scan your repository and surface what to improve.tessl launch resume- resume an interrupted or completed cloud launch run.Signed release verification - the installer verifies the release signature before installing.
Improvements
Agent works without native search tools - uses
fd/rgwhen available and falls back to a basic code implementation when they are not installed.Verify cache relocated - now stored at
~/.tessl/verify-cache, so cached results are shared across projects instead of living in each checkout.Auto-detect workspace -
tessl review run/review fixread the workspace fromtessl.jsoninstead of always prompting.tessl launch listnow shows the workspace and the run's creator.tessl eval listconsolidates injected context into a single column.Credit errors link to top-up - an out-of-credits error now points to the upgrade / top-up flow.
Explicit, persistent agent setup -
tessl initnow records selected agents intessl.jsonfor reproducible installs across machines. Re-runtessl initon an existing project to update the list.Clearer permission prompts - prompts are deduped per tool call, bash paths are classified by read/write/delete, external and sensitive-path actions route through the auto classifier, and auto-mode prompt wording is combined.
Changes
Separate
--agentand--modelflags - compound--agent <agent>:<model>tuples are now split into--agent <agent> --model <model>. The old form still works but is deprecated and warns.
Bug Fixes
Installer validates the remote release version before installing.
Generic hook command/args aligned to the
exec/shellforms.
0.90.0
Breaking Changes
tessl review <target>(withoutrun) no longer runs a review - it now shows thereviewcommand group's help instead. Usetessl review run <target>(ortessl review run quality <target>).
New Features
tessl review run quality/tessl review run security-tessl review runis now a subcommand group:quality(the default, unchanged behavior) scores a skill against a rubric, andsecurityruns a Snyk-powered security scan - replacing the standalonetessl security-reviewcommand.tessl review list,view, andretrynow work across both kinds from a single unified history, with a--fail-onflag mirroring--thresholdfor security scans.tessl review run <target>continues to work exactly as before - it's shorthand fortessl review run quality <target>.Clone skills from GitLab and Bitbucket sources - Skill installation and inventory scanning now support GitLab and Bitbucket repository sources, not just GitHub.
Bug Fixes
Fixed
tessl agentignoring a saved default model fromsettings.jsonon startup.tessl agent- Fixed session approval matching for external paths when multiple patterns are involved.
0.89.0
New Features
tessl agentout in Open Beta - It helps you build and optimize your software factory one workflow at a time.tessl changecommands to aid with automated code reviewstessl change risk- Assess PR/diff risk and decide whether human review is required.tessl change verify- Verify code against configured verifiers.tessl change review- Review the current diff with reviewer skills and emit structured review data.Use
tessl agentto set them up!
tessl launch skill- Run skills using your preferred agent in order to automate parts of your workflow with skills.tessl mcp proxy- Connect to MCP servers through an MCP gateway set-up in a workspace’s settings.
Improvements
Clearer error when
--skillcan't apply -tessl install --skill <name>now fails fast with an actionable message when given zero sources or more than one source, instead of silently installing nothing.Friendlier model-lock message on eval runs - Selecting a non-default model on a Free plan now produces a single, clear message explaining how to proceed, instead of a raw
403 Forbidden.
Bug Fixes
Fixed relative
file:sources (e.g.tessl install file:../my-source --global) failing to resolve; they now resolve against your current working directory as expected.Fixed a single unsupported entry in a plugin's
.mcp.jsonfailing the whole file at publish and install time; unsupported entries are now skipped and the rest of the plugin installs.
0.88.2
Bug Fixes
npm package - fixup README.md file
0.88.1
Bug Fixes
Global plugin MCP servers -
tessl install --globalnow writes a plugin's MCP server config to each agent's real user-level config.
0.88.0
New Features
Plugin MCP Servers - Plugins can now declare MCP servers in a bundled
.mcp.jsonat the package root.Publish Through Symlinks -
tessl skill publishandtessl plugin publishaccept an opt-in--resolve-symlinksflag that copies a symlink target's bytes into the published tarball (within a safe boundary), so authors can reuse files from elsewhere in the repo.
Improvements
Workspace Scoping for Reviews -
tessl review viewandtessl review retrynow accept--workspace/-w, and--lastresolves the most recent run within that workspace.Publish OIDC Warning - When publishing from GitHub Actions without an OIDC token permission, the CLI now warns instead of failing opaquely.
Bug Fixes
Fixed
tessl skill review --threshold 0incorrectly emitting a "Skill validation failed" error.
0.87.0
Breaking Changes
Skill review now requires a Tessl account. Both
tessl reviewand the oldertessl skill reviewnow require authentication: sign in withtessl login, or set aTESSL_TOKENAPI key in the environment for CI. Reviews run on Tessl's servers, so anonymous review runs are no longer supported.
Deprecations
tessl skill reviewis deprecated - usetessl reviewinstead.tessl review(aliastessl review run) is the replacement: an async, server-side review with companionview,list,retry, andfixcommands. The old command still runs for now but prints a deprecation warning on every run and will be removed in a future release. Replacetessl skill review <path>withtessl review <path>.
New Features
tessl reviewis now fully launched as an end-to-end workflow - review runs are first-class in the CLI withrunas the default subcommand, and companion commands to view, retry, and fix reviews directly from the terminal.Flexible reviewer selection - you can target a specific reviewer with
--review-pluginor use your workspace's default reviewer configuration.
Improvements
Richer review output for debugging and automation -
tessl review viewnow renders dynamic judges per run, and review JSON includes reviewer/plugin identity metadata.Clearer
tessl eval viewoutput - run labels are shown and scenarios are sorted for easier reading.More informative
tessl eval runstart output - pre-run context details are surfaced before execution.
Bug Fixes
Review command reliability fixes -
tessl review list,view, andretrynow resolve workspace names correctly, and--jsonwithout--workspacenow returns a clear error.Fixed completed scenario counts in multi-solution eval runs.
Fixed evaluator failures caused by repeated plugin installation arguments.
0.86.0
New Features
Customise the eval-scenarios run when publishing - added
--eval-scenarios <scenario-search-path>totessl plugin publish/tessl skill publish. The default is./evalsin the directory of the plugin being published.
Improvements
Default eval model is now DeepSeek v4 Flash.
tessl eval list --context-type- filter eval runs by the type of context injected into scenarios for the "with context" variant.Richer
tessl eval view- clearer variant labels, an injected-context block, scenario paths, and repo/plugin provenance.tessl eval runechoes the scenario search directory and count before starting.Commit-fixture uploads are grouped and deduped to remove some cases where redundant context was uploaded.
Install source policy: git-source allowlist, with denial messages that name the offending source.
You're prompted to accept pending invites before a personal org is created.
0.85.0
Breaking Changes
tessl eval run --agent is now single-valued - Previously
--agentwas repeatable and each value created a separate eval run. It now accepts a single agent; run the command once per agent to compare.Removed legacy eval-run context flags -
--variant,--context-ref, and--context-patternhave been removed fromtessl eval runin favour of the new--contextselection (see below).
New Features
Skill Inventory - Skill Inventory gives you a living map of every skill in your GitHub org - what exists, where it's used, and where you're duplicating effort. Run the initial import with
tessl inventory importand it scans your repos, collects your skills and manifests, and gives you a snapshot of your whole inventory. Run it again any time - each scan is diffed, so you get a living view of what's new, unchanged, and removed over time.Context Selection for tessl eval run - A single
--context <path>front door now picks the context under test, with--context-committo source it from a commit and--skill(repeatable) to narrow a local plugin to specific skills.Control Baseline by Default -
tessl eval runnow always runs a control variant to compare against, with--skip-baselineto opt out.Secrets injection for plugin evals -
tessl eval runnow accepts--env-file <path>. Variables in the file are encrypted client-side and delivered into the eval sandbox, where they are available tosetup.shscripts and the agent. See Passing secrets to an evaluation.--child Flag for Nested Projects - tessl project create now requires
--childto create a project nested inside an existing one, and blocks with a clear explanation when a parent project is detected in an ancestor directory.tessl version - Bump a plugin's version locally without publishing, like
npm version. Passpatch,minor, ormajorto increment the current version following semver, or an explicit version (e.g.tessl version 2.1.0) to set it directly. Updates the plugin manifest in place; an optional path argument targets a directory other than the current one.
Improvements
Clearer Install Output -
tessl installnow shows only the dependencies you explicitly requested on the success line; incidental re-installs are summarised as a dimSynced: N count.tessl scenario generate workspace resolution - Workspace is now resolved from your linked Tessl project (
tessl.json), the--workspaceflag, or an interactive prompt — instead of being derived from the tile manifest name, which caused confusing 403 errors when the manifest used thelocal/ prefix. The--workspaceflag is now accepted for tile-based generation.
0.84.0
New Features
Bootstrap Project Create -
tessl project createnow works in directories that don't yet have atessl.json, bootstrapping it as part of the create flow.Personal GitHub Account in Skill Inventory Import -
tessl skill inventory importcan now authenticate with a personal GitHub account, not just org-level credentials.Plugin Marketplace Discovery - Tessl now classifies
.claude-plugin/marketplace.jsonas a first-party manifest, picking up plugins from that location.
Improvements
Warning for Large-Scale Eval Runs -
tessl eval runnow prompts a confirmation before launching large eval batches.Plan-Entitlement-Gated Model and Agent Selection - model and agent selection respects plan entitlements with clearer messages when a selection isn't available.
Age-Gated Registry Sources Fallback - registry sources blocked by release-age policy can now resolve to an older fallback source rather than hard-blocking.
Bug Fixes
Fixed
tessl installto fast-fail on private or missing git repositories instead of silently succeeding with a hidden failure.Fixed the judge-results display to show the correct score denominator in both CLI and frontend.
Windows installer (new distribution channel)
Signed Windows installers are now available for direct download. The Inno installer wraps a signed tessl.exe bundled with TESSL_DISABLE_UPDATE (winget will manage updates):
https://install.tessl.io/installers-windows/0.84.0/TesslSetup-0.84.0-x64.exe
https://install.tessl.io/installers-windows/0.84.0/TesslSetup-0.84.0-arm64.exe
The signed package will be installable directly via winget install tessl.tessl as soon as it will be approved by Microsoft
0.83.0
New Features
**Jujutsu Repo Support -
tessl project repairnow detects and handlesjj-managed repositories alongside Git.Finer Eval Run Controls -
tessl eval runadds two independent opt-outs:--skip-forced-context-activationand--skip-scoring. Use them on their own or together to control whether the run forces context activation and whether the rubric scorer fires.
Improvements
Solver and Scorer Flag Deprecation - The
--solverand--scorerflags on tessl eval run are now hidden but still functional, with a one-line deprecation warning; prefer the new--skip-*flags.
Bug Fixes
**Removed a vendor-native plugin-manifest ingestion path that could pick up stale manifests outside the expected resolution flow.
0.82.0
Improvements
Install Policy Enforcement -
tessl installnow honors org-configured release-age and commit-age policies. For registry sources, the CLI automatically falls back to an older version that satisfies the policy (with a clear reason in the install output) or hard-blocks if no version qualifies. For git sources, it resolves to the most recent commit old enough to satisfy the minimum commit-age policy instead of installing HEAD.Policy-Aware
tessl outdated- Versions blocked by a release-age policy are now annotated as[release age policy]in the update table, and git sources show the latest age-compliant commit as the recommended update so you can see what will (and won't) be installed before runningtessl update.
0.81.3
Improvements
Eval Failure Reasons -
eval runandeval viewnow display the reason when a run fails (e.g. quota exceeded), instead of a bare failure markerEval Default Model Notice - A one-time notice informs you that the default eval model is now GLM 5.1, with guidance on selecting a different model
Resilient Eval Polling -
eval runnow rides out transient server errors and network blips while polling, instead of reporting a completed run as failedClearer Validation Errors - Manifest schema errors are now rendered in a readable format instead of a raw JSON dump
MCP Tool Updates - The
new_tileMCP tool is renamed tonew_plugin, and theoutdatedtool now accepts aprojectDirparameter to check a specific directory
Bug Fixes
Fixed
plugin packfailing with a missingtile.jsonerror for plugins created withplugin new; migrated plugins also no longer pack from the stale legacy manifestFixed
eval runevaluating the stale legacytile.jsoninstead of.tessl-plugin/plugin.jsonwhen both manifests are presentPublishing a migrated plugin now errors if
tile.jsondeclaresprivate: truebutplugin.jsonomits it, preventing a private plugin from accidentally going publicFixed broken documentation links shown after
plugin newandskill newRemoved misleading advice pointing at
tile.jsonfrom the "no content" validation error
0.81.2
Bug Fixes
scenario generate: Clearer Error When No Manifest Found — Runningtessl scenario generatein a directory with no manifest previously crashed with a confusingENOENT: tile.jsonerror. It now shows a clear message pointing you to add a.tessl-plugin/plugin.json.
0.81.1
Bug Fixes
Fixed
skill publishincorrectly triggering the import wizard whenplugin.jsonalready existsFixed
skill publish --bumpnot writing the bumped version toplugin.json, causing the old version to be publishedFixed
skill publishpre-publish version checks reading fromtile.jsoninstead ofplugin.json
0.81.0
New Features
Tiles are now Plugins - This release completes the switch from Tiles to Plugins. The CLI now uses "plugin" across every command, help listing, flag description, and message. For more information on how to migrate from Tiles to Plugins, there is a guide in the documentation.
Full moderation status in
plugin info-plugin infonow shows the complete moderation state for a published version (pass, pending, skipped, fail, or error).
Improvements
lsshortcut -tessl lsnow works as a shortcut fortessl list, mirroring the existingi→installshortcut.Workspace-scoped uploads - Eval-related uploads (scenario tarballs, plugin archives, repo archives) are now scoped to the active workspace, so teammates in the same workspace can access uploads created by other members.
Bug Fixes
Eval run links now point directly to workspace-scoped URLs, skipping the redirect members previously hit when clicking through.
scenario generatenow works in plugin-only directories (a.tessl-plugin/plugin.jsonwith notile.json), which previously failed with a "tile.json not found" error.The CLI no longer fails to start when its log file can't be written (e.g. in sandboxed or read-only environments) — file logging is now best-effort.
0.80.0
New Features
Eval Enablement Checks -
tessl scenario generate,tessl tile publish, andtessl skill publishnow pre-flight check whether the target workspace has evals enabled. Scenario generation fails fast with a clear message; publish still succeeds but cleanly skips the eval upload with a single info line.
Improvements
Cleaner Publish Output -
tessl tile publishno longer prints validation warnings twice (once from pre-publish validate, once from pack).Clearer Forbidden Errors - When creating a project fails because the workspace doesn't exist or you lack permission, the CLI now shows an actionable message instead of a generic
403 Forbidden.Skill Install Paths - Skills are no longer written under
.gemini/skills; installation routes through.agents/skills, and any legacytessl:*/tessl__*entries left in.gemini/skillsare cleaned up automatically.
Bug Fixes
tessl tile newnow preserves the rule description you provide instead of overwriting it with aTODOplaceholder.Generated
RULES.mdnow ends with a trailing newline.
0.79.1
Improvements
Clearer Guidance for Missing Project Links - When a linked Tessl project can't be found or isn't accessible, the CLI now surfaces actionable next steps with specific
tessl project createandtessl project repaircommands instead of a raw 404. Thetessl eval runhelp text now also explains that eval runs are saved to a Tessl project.
0.79.0
New Features
OpenHands agent support (alpha) —
tessl init,tessl install, andtessl runnow recognise OpenHands. Auto-detection follows the standard project → home → PATH ladder; OpenHands is excluded from the interactive picker while in alpha but can be selected explicitly via--agents openhands.tessl search --global— install search results into~/.tessl/without requiring a project to be initialised. Short formgavailable.tessl eval run --list-agents— print the supported<agent>:<model>catalogue (with the default marked) without running an eval. Supports--jsonfor scripting.tessl project- Tessl now supports workspace-backed projects in the CLI, giving your local work a persistent project identity for evals and other project-based workflows. Usetessl project createto create a project,tessl project linkto connect an existing one, andtessl project repairto fix broken project links.tessl eval run --scorer-agent— override the agent and model used for the score step (asagent:model), while the solver agent stays unchanged.tessl eval viewshows the override under aScored by:line.tessl eval run --quality-check— opt-in flag that asks the backend's LLM judge to filter out misleading scenarios (low feasibility, rubric leakage, low value) before solve and score. Excluded scenarios show up under a red✗ Excluded by quality checkline intessl eval view.tessl tile publish --with-scenario-quality-checkenables the same filter for the eval that runs as part of publishing.
Improvements
Simpler
tessl skill import/skill new— no longer prompts for workspace or visibility; defaults tolocalworkspace andprivatevisibility. Pass flags explicitly to override.Scenario config (
scenario.json) — declarative working-directory setup for evals. Declarefixturesto install (commit or directory),includepaths to copy in verbatim, andsetupscripts to run after install. Conventional defaults (resources/auto-included,setup.shauto-run) mean most scenarios need noscenario.jsonat all.tessl scenario generatenow produces ascenario.jsonfor every generated scenario, plus any supporting input state (e.g.resources/) when the source commit needs it. Setup scripts are off by default per workspace — contact Tessl to enable.Cleaner install error messages — local paths missing the
file:prefix now surface a clear validation error instead of a generic parse failure.Softer security-review copy — surfaces showing a per-skill security status now display "No security review available." instead of "Security review has not been run yet."
tessl skill reviewincludes referenced skill content — skill reviews now include all referenced content and scripts for logged-in users.
Bug Fixes
Install exits non-zero on failure —
tessl installandtessl install --globalnow reliably propagate tile install failures as command failures (non-zero exit code).tessl scenario generate <relative-path>— relative paths liketiles/fooare now correctly routed to the tile flow when the directory exists locally, instead of misrouting to the repo flow and erroring on missing-commits/-prs.tessl tile lint—@decoratortokens in markdown headings and YAML frontmatter are no longer treated as hard-link references and no longer produce false-positive lint warnings.MCP install bootstrap message — the "Initialising new tessl project at …" message no longer prints during bulk sync installs that don't actually write
tessl.json.Experimental agent detection — explicit project-level usage of experimental agents (e.g. OpenClaw workspace markers) is now respected ahead of the experimental gate, and the default install flow no longer force-enables experimental agents.
0.78.0
New Features
Activation Solver for Evals -
tessl eval run --solver=activationmeasures which skills activate for each scenario, andtessl eval viewrenders the results in a per-scenario activation tableSet Project Name on Init -
tessl initaccepts a new--nameflag to set the project name intessl.jsonat creation timeTarget Org on Workspace Create -
tessl workspace createnow accepts a--org-idflag to associate a workspace with a specific organizationList Organizations - New
tessl org listcommand displays the organizations you belong toScenario Quality Checks for Evals -
tessl eval run --quality-checkwill filter out scenarios that would give misleading results, based on a quality assessment that looks for things like “criteria leaking into the task” or “task duplicating information from the skill it is meant to exercise”
Improvements
Clearer Eval Run Status - Pending and in-progress eval and generation runs render as yellow "In Progress" with elapsed time, instead of an ambiguous "Pending"
Better Invalid Manifest Errors - tessl eval run against a directory with a malformed tile.json now reports the manifest error directly with a hint to fix it, instead of falling through to the scenarios flow
Removed Eval Compare - tessl eval compare has been removed. Use tessl eval view and tessl eval list instead
Global Install from Search -
tessl searchnow supports--globalso selecting a result installs it to~/.tessl/instead of the current project
Bug Fixes
Fixed tile rule creation to safely handle prompts containing
/so they no longer create unintended nested paths in the generated rule files
0.77.0
New Features
Experimental Windows Support - The Tessl CLI is now available on Windows as an experimental release. Install it with PowerShell:
Eval Setup Scripts - Eval scenarios support a new
setupfield inscenario.json— an ordered array of script paths that run after fixtures and includes are installed, before the solver agent starts.
Improvements
Cleaner Top-Level Help - Simplified top-level CLI help.
0.76.0
New Features
Eval Progress Bars —
eval runandeval viewnow show real-time per-scenario progress bars with colour-coded status (complete, active, queued)Directory Fixtures in Evals — Scenarios can now declare
includepaths for directory-based fixtures, alongside existing commit-based fixtures."latest" Dependency Version — Use
"latest"as a dependency version intessl.jsonto always resolve the most recent published versionUninstall Individual Skills —
tessl uninstall --skill <name>removes specific skills from a dependency instead of removing the entire tileVerifiers in Tile Packing — The
verifiers/directory is now included when packing tiles (when evals are enabled)Failed Security Review Visibility — Security reviews that failed to run are now shown as "failed" instead of appearing as "pending"
Improvements
Project Name from Directory —
tessl initnow derives the project name from the directory basename instead of using a generic defaultArchive Without Version —
tessl archivenow works without a version suffix, allowing you to archive all versions of a tile at onceEval Agent/Model Display —
eval viewnow shows the agent and model for all eval run typesWorkspace Commands —
-userflag renamed to-username,-userstill works with a deprecation warningHelp Text Corrections — Improved descriptions for
install --skip-init,tile pack,skill import, andconfig set
Bug Fixes
Fixed eval scenario path resolution when base directory is "."
Fixed eval git diff ignoring user's custom diff tool configuration
Fixed object metadata serialization in eval debug output
Breaking Changes
Removed
--project-dependencies— The--project-dependenciesflag has been removed fromtessl installandtessl init. Dependency scanning and automatic tile matching are no longer part of the install flow. Usetessl searchto find relevant tiles instead.
0.75.0
New Features
API Key Management — New
api-keycommand group withcreate,list, anddeletesubcommands for managing workspace-scoped API keys. Supports both interactive and non-interactive (scripting) modesAuto-Select Single Workspace — When you're a member of only one workspace, the CLI now skips the workspace selection prompt and selects it automatically
Breaking Changes
auth tokenRemoved — Theauth tokencommand has been removed. Use the newapi-key create,api-key list, andapi-key deletecommands instead for workspace-scoped API key management
0.74.0
New Features
Machine-Readable Search:
tessl search --jsonflag outputs results in JSON format for scripting and automationSkill Review Threshold:
tessl skill reviewnow supports a--thresholdoption: when the score is below this threshold, the command will fail - helpful for CI use casesScores in Search & Info: Search results and
tessl tile infonow display quality scores and security review details
Improvements
Piped Token Output:
tessl auth tokennow suppresses the spinner and hints when output is piped, making it easier to use in scriptsBetter Error Display: Failed operations now render a red cross indicator for clearer error visibility
Search Column Alignment: Interactive search results now have properly aligned columns
Remove Steering to Use
query_library_docsMCP tool: It was getting in the way of skill activation from some users. You can manually opt-in to install the rules yourself withtessl install tessl/cli-setup
Bug Fixes
Fixed skill review API calls failing due to stale authentication tokens
Fixed eval commands resolving git repo root incorrectly when run from subdirectories
0.73.0
New Features
Security Reviews on Install -
tessl installandtessl updatenow show security review results before installation. CRITICAL/RISKY findings require confirmation to proceed, ADVISORY findings show an advisory after install, and unscanned items display a warning. Use-dangerously-ignore-securityto bypass prompts in CI/scripted contextsCommit-Pinned Installs -
tessl installnow acceptsgithub:<repo>@<sha>and full GitHub commit URLs, allowing you to install a skill at a specific commit. A post-install hint directs totessl updatefor future updatesPublish
--bumpFlag -tessl tile publishandtessl skill publishnow accept--bump patch|minor|majorto auto-increment the version when the current version already exists in the registry.agents/skillsDirectory Support - Install skills in.agents/skillsalongside other requested agents since that’s the folder many tools are aligning with
Improvements
Grouped Search Results -
tessl searchnow groups results by type (Tiles / Skills) with section headers when both types are present
Bug Fixes
Fixed
tessl skill newshowing interactive prompts even when all required flags (-name,-description,-workspace) are providedFixed MCP server processes becoming orphaned when the parent process disconnects (stdin closes)
0.72.0
New Features
Pre-Publish Validation & Dry Run - Tile and skill publish commands now validate permissions, workspace, and version availability before publishing, with clear pass/fail output. Use
--dry-runto check without actually publishing.Security Scores in Search - Search results now display security assessment levels (Passed, Caution, Risky, Critical) alongside tile scores
Improvements
Smarter Eval Scenario Generation - Existing scenarios are now considered when generating new ones, avoiding duplicates
Large File Exclusion in Eval Archives - Files over 10MB are automatically excluded from repo archives during eval runs
Eval Commit Ref Validation - Commit refs are validated before archive creation, with clear error messages for missing refs
0.71.0
New Features
Support for Copilot in VSCode — Skills, rules, and our MCP server can be automatically set-up for vscode
Eval Run Labels — New
--label/-lflag ontessl eval runlets you attach a short description to a run. Labels appear intessl eval listand the Tessl web UI, making it easier to identify what you were testing across multiple runs.Eval Variant Selection — New
--variantflag ontessl eval runlets you run only a specific variant. Pass--variant without-contextto run the baseline only (useful for iterating on scenario quality without affecting the with-context comparison), or--variant with-contextto skip the baseline.Local Repo Eval Runs — Project evals can now run against local git repos without SCM integration; the CLI archives and uploads the repo automatically
Smarter Scenario Generation —
tessl eval generatenow avoids duplicating existing scenarios when generating new ones;--countspecifies how many new scenarios to add
Bug Fixes
Allow installation of skills from unknown dot folders in GitHub repositories (e.g.,
.agent-skills/)
0.70.1
Improvements
Non-Interactive Mode for Evals & Scenarios —
tessl eval runandtessl scenario generatenow print the run/generation ID and URL immediately when running non-interactively, instead of polling for completionClearer Help Text —
tessl eval runandtessl scenario generatenow show which flags are mode-specific, and invalid flag combinations are rejected with helpful messages
Bug Fixes
Fixed install --watch-local exiting prematurely — the process now stays alive until Ctrl+C and updated output to show relative paths rather than absolute ones
Fixed installation from
file:source to exclude .git directories - It now installs the same files that would be captured bytessl tile packortessl tile publish
0.70.0
New Features
Local Tile Watching — New
--watch-localflag ontessl installwatches local file-source tiles for changes and automatically reinstalls tiles, streamlining the tile development workflowSearch Score Display —
tessl searchresults now show aggregate quality and impact scores with color-coded badgesScenario Generation from PRs — New
--prsflag on tessl scenario generate accepts PR numbers as an alternative to--commitsMultiple Scenario Downloads —
tessl scenario downloadnow accepts multiple space-separated IDs (e.g.,tessl scenario download id1 id2)Eval Run Repeats — New
--runs / -nflag ontessl eval runto repeat each agent configuration multiple timesEval Polling for Tile Evals — Tile evals now poll for completion instead of returning immediately, with Ctrl+C to detach gracefully
Eval JSON Output for Tile Evals —
--jsonflag ontessl eval runnow works for tile evals, outputting run ID, tile name, and scenario countEval Agent Flag — New
--agentflag (format:agent:model) replaces--modelfor tile evals, aligning with project eval conventionsEval Cost Metadata —
tessl eval viewnow displays cost, runtime, turns, and token usage below each solutionEval Agent/Model Display —
tessl eval viewstats now show the agent and model used for each solution--lastfor Eval Debug & Retry —tessl eval debugandtessl eval retrynow support--lastfor quick access to the most recent eval runRepository Metadata in tile.json — Tiles now support an optional repository URL field in their manifest
Improvements
Tile Cache Protection — Tile authoring commands now warn when operating on paths inside
.tessl/tiles/, preventing accidental edits that would be overwritten on the next installCleaner Help Text — Removed meaningless
--no-{flag}negated boolean flags from all commands, improved flag capitalization, and reordered commands for logical groupingConsistent Scenario Terminology — "Generation run" renamed to "generation" throughout the CLI for simpler, more natural language
Scenario Generate Table Output —
tessl scenario generateresults now render as a formatted table with Scenario ID and Commit ID columnsSmarter Binary Install — Skips re-downloading binaries that already exist and pass validation; corrupt binaries are automatically cleaned up
Fixes
Fixed CLI crashes when output streams disconnect unexpectedly (EPIPE handling)
Fixed
unpublishhelp text to reflect the correct 2-day timeframe (was showing 2 hours)
0.69.0
New Features
Scenario Generation Commands - New
tessl scenariocommand suite for generating and managing test scenarios. Generate scenarios from tiles or repository commits (tessl scenario generate), download them to disk (tessl scenario download), and track generation runs (tessl scenario list,tessl scenario view)Global Tile Installation - Install tiles globally with
tessl install --globalto make documentation and skills available across all your projects.Eval Variant Comparison -
tessl eval runnow supports running evaluations with multiple agent variants and context patterns, with automatic detection of tile vs. project scenario sources
Improvements
Project Directory Hints -
tessl initandtessl installnow display a helpful hint when the target project directory differs from your current working directory
Bug Fixes
Fixed a crash when piping CLI output to another command (e.g.,
tessl list | head) by gracefully handling broken pipe signalsFixed markdown link validation incorrectly parsing non-markdown files during tile linting
0.68.0
New Features
GitHub Copilot CLI Support — Tessl now recognizes GitHub Copilot CLI as an agent, with automatic detection, rules wiring via
AGENTS.md, skill installation, and MCP configurationSearch Type Filtering —
tessl searchnow accepts a--typeflag to filter results by content type (skills, docs, or rules)Skill Review Auto-Accept —
tessl skill review --optimizenow supports a--yes / -yflag to skip the confirmation prompt and auto-apply improvements
Improvements
Automatic Binary Cleanup — Old CLI binary versions are now automatically cleaned up after updates, keeping only the current version and one rollback
Short SHAs for Git Tiles —
tessl listandtessl doctornow display short SHAs for git-sourced tiles instead of full commit hashesCommand Detection Timeout — Command lookups now have a 1-second timeout to prevent indefinite hangs during agent detection
Breaking Changes
tessl skill searchRemoved — Usetessl search--type skills instead
Bug Fixes
Fixed
tessl skill review --optimizefailing with a raw 401 error when not authenticated — now shows a clear login promptFixed
unpublishhelp text to reflect the correct 2-day window (was incorrectly showing 2 hours)
0.67.0
New Features
Skill Optimization -
tessl skill review --optimizenow applies feedback from the review to generate an updated SKILL.md fileEvaluation Type Support -
tessl eval listnow displays all evaluation types (tile, repo, skill) with a new "Type" column and--typeflag to filter by evaluation typeFilter Evaluations by Status -
tessl eval listnow supports a--statusflag to filter runs by status (pending, in_progress, completed, failed)
Bug Fixes
Fixed
tessl skill reviewreturning exit code 0 on validation failure — it now correctly returns a non-zero exit code, enabling proper CI/CD integrationFixed
tessl api --input- sending incorrect Content-Type when piping JSON via stdin
0.66.0
New Features
outdatedcommand — Check installed tiles for newer versions, showing current, safe update, and latest version infoupdatecommand — Update tiles to newer versions. Use--yesfor all, and--forceto include breaking updates
0.65.0
Bug Fixes
Windows Compatibility for Generated Files - Fixes generated file and directory names containing colons (
:) which are invalid in Windows file paths. Tile files committed to git repositories can now be cloned on Windows without errors. Existing installations are migrated automatically
0.64.0
New Features
Local Tile Evaluation - Run evals against your tiles directly from the CLI with
tessl eval runand get a fast feedback loop for improving your tilesEval Results in Terminal - View eval results with per-scenario breakdowns, variant comparisons, and scoring summaries using
tessl eval viewEval Run History - List recent eval runs filtered by workspace, tile, or author with
tessl eval listEval Retry - Re-run failed evals with
tessl eval retry
0.63.4
Improvements
Internal - Stability improvements
0.63.3
New Features
Local Path Support for Tile Info -
tessl tile infonow accepts a local directory path as an argument and defaults to the current directory when no argument is provided, making it consistent with other tile commands likepublishandlint
Improvements
Better Publish Messages - After publishing tiles or skills, the CLI now displays the published resource URL and a note about moderation timelines
Bug Fixes
Fixed MCP configuration failures when using
npx tesslby ensuring the tessl binary is accessible via the PATH duringinit
0.63.2
Bug Fixes
Fixed circular reference issues when
CLAUDE.mdandAGENTS.mdare symlinked
0.63.0
Improvements
The CLI is now distributed as a native binary instead of a bundled Node.js package
0.62.2
New Features
Optional Authentication - You can now use
tessl init,tessl install, andtessl searchwithout logging in. Public tiles are accessible to everyone, while private tiles will show helpful hints to log in when needed
Bug Fixes
Fixed
--skillflag not working correctly when installing a single skill from a local tile with multiple skills
0.62.1
Improvements
Internal - Stability improvements
0.62.0
New Features
Unified Search —
tessl searchnow returns both tiles and skills in a single view, with visual badges showing content types ([docs], [skills], [rules]) and skill provenanceTile Evaluations — New tessl eval command group for evaluating tiles:
tessl eval run [path]— Run evaluations on local tiles--forceflag to re-run all evaluations including previously solved cases
tessl eval list— View recent eval runs with statustessl eval view-results <id>— View detailed results with color-coded scores and assessment tables--lastflag to quickly view most recent eval results
Git metadata (branch, commit, dirty state) automatically attached to eval runs
Tile Info — New
tessl tile info <name>command to view tile metadata, verification status, and moderation statusSkills in MCP Context — The
query_library_docsMCP tool now includes installed skills when building knowledge context
Improvements
Redesigned Help for
tessl -h— Commands are now grouped by category with improved formatting and readabilityPublish Workspace Context — Publishing now shows the target workspace name before uploading
Bug Fixes
Fixed
--skillflag being ignored when installing skills from registry tilesFixed re-installing tiles not updating the manifest with new skill selections
Fixed tile lint incorrectly flagging files as orphaned when linked via
@path.mdincludes
0.61.4
Improvements
Install
--yesFlag Behavior - The--yesflag now auto-selects all skills when installing from GitHub, even in interactive mode. Previously it only worked in non-interactive environments.Non-Interactive tile new - The tessl tile new command can now run fully non-interactively when all required flags are provided, making it easier for scripts and agents to use.
Fixes
GitHub Skill Installation Bugfixes - Address various edge cases that prevented some skills being installed from GitHub
GitHub Skill Installation Respects Pinned Version - Fixed an issue that meant we always installed a skill from a repository's trunk rather than the commit sha in
tessl.jsonwhen doingtessl install
0.61.3
Improvements
Faster git installs - Git dependencies are no longer re-downloaded on every install when already at the correct version
0.61.2
Improvements
Windows Platform Detection - The CLI now detects Windows and provides a clear error message directing users to use WSL instead
Lenient GitHub Skill Installation - Skills from GitHub with missing referenced files or minor schema issues now install with warnings instead of failing completely
Better Warning Display - Installation warnings are now grouped by tile name with count summaries (e.g., "3 content warnings in github:user/repo")
Verbose Install Output - Added
--verbose(-v) flag totessl installandtessl skill searchcommands to display detailed warning messages during installation
Bug Fixes
Fixed skill validation warnings showing absolute temp directory paths instead of relative paths
Fixed installation failures when GitHub skills have invalid optional frontmatter fields (e.g.,
allowed-toolsas array instead of string)
0.61.1
New Features
Skill Commands - Added a complete set of dedicated skill management commands:
tessl skill new,tessl skill import,tessl skill lint,tessl skill publish,tessl skill review, andtessl skill search. Skills are now first-class citizens with their own command group for easier discovery and management.GitHub Installation Support - Install tiles and skills directly from GitHub repositories using
tessl install github:user/repoor full URLs. Supports branch selection, subdirectories, and interactive skill selection. Git sources are pinned to commit SHAs for version stability.Skill Search - Discover available skills across the Tessl ecosystem with the new interactive
tessl skill searchcommand. Search returns both external skills from GitHub and tiles containing skills, with interactive selection and installation.Skill Review - Evaluate skill quality with
tessl skill review, which validates SKILL.md files and provides LLM-based scoring across multiple dimensions with actionable suggestions for improvement. Supports both local paths and GitHub URLs.Non-Interactive Mode - Commands now auto-detect TTY availability and work in CI/CD pipelines and with AI agents. When required flags are missing in non-interactive environments, commands provide clear error messages pointing to available options.
Selective Skill Installation - Choose specific skills when installing tiles using the new
include.skillsmanifest field in tessl.json. Reduces clutter in agent directories by only activating the skills you need.Codex Support - Full support for Codex as a core agent alongside Claude Code, Cursor, and Gemini. Includes project detection, MCP configuration, steering, and skills synchronization.
Gemini Production Ready - Gemini agent is no longer experimental and fully supported in production workflows.
Improvements
Simplified Skill Naming - Skill directories now use cleaner names (
tessl:<skill>instead oftessl:<workspace>:<tile>:<skill>) and are symlinked rather than copied for better performance and consistency.Automatic Eval Publishing - Evals are now published by default when running
tessl tile publishortessl skill publish. Use-skip-evalsto opt out. Published evals automatically trigger evaluation runs.Better Skill Discovery - Improved skill detection uses a three-step process (root check, priority directories, full scan) with optimizations that reduce scan time and exclude build/cache directories.
Streamlined Publishing - The
tessl skill publishcommand no longer asks redundant "will you share this?" prompts since publishing inherently means sharing.Improved Help Text - Updated
tessl init --agentto list all supported agents (claude-code, codex, cursor, gemini) and clarified thattessl installaccepts both registry tiles and GitHub URLs. Addedtessl ias a shortcut alias.Relative Paths in Manifest - When creating tiles with
--install, the CLI now stores relative paths in tessl.json instead of absolute paths, making projects portable across machines and directories.Smarter CLI Setup - The tessl/cli-setup tile is now only installed when your tiles have documentation, reducing overhead for steering-only projects.
Flexible Tile Content - Tiles can now contain any file type, not just markdown files, allowing for configuration files, code examples, and other documentation formats.
Bug Fixes
Fixed skill review score display showing
/4instead of the correct/3scaleFixed status command handling of non-semver versions for git-based and file-based tiles
Fixed orphaned file detection for tiles with root-level skills - README.md and other root files are no longer incorrectly flagged as orphaned
Fixed skill publish command to accept SKILL.md file paths directly instead of only directory paths
Fixed file source tiles being incorrectly deleted as orphaned on repeated installs when dependency key differed from tile name
Fixed skill frontmatter validation warnings during installation from external sources like GitHub
Fixed
tessl skill newoutput messages to reference correct tile directory pathsFixed skill selection in GitHub repos to require explicit choices, preventing accidental installation of all skills from large repositories
0.60.0
New Features
Project Mode (Managed vs Vendored) - Choose how tile content is managed in your project:
Managed mode - Tile contents are gitignored like
node_modules(default for existing projects)Vendored mode - Tile contents are committed to your repository (default for new projects)
Switch modes anytime by setting
"mode": "managed"or"mode": "vendored"intessl.json
Improvements
Simplified Local Tile Dependencies - Local tiles (using
file:orlink:sources) no longer require aversionfield intessl.json. The CLI automatically reads versions from installedtile.jsonfiles. Existing manifests with bothversionandsourceare automatically migrated to the new format.
0.59.0
New Features
.tileignoreSupport - Exclude files from tile validation and packaging using gitignore-style patterns.
0.58.1
Improvements
Tile Commands Auto-Detect -
tessl tile pack,tessl tile lint, andtessl tile publishcan now be run directly from your tile directory without explicitly specifying the path
Bug Fixes
Squashed some bugs that were hiding in the codebase. They know what they did.
0.58.0
New Features
Context Cost Analysis (Experimental) - The
tessl doctorandtessl tile lintcommands now display estimated token costs for tile content loaded into agent context windows. This helps you understand which tiles contribute most to context usage and identify oversized content before publishing.HTTP Proxy Support - The CLI now works in proxied network environments by automatically detecting and using HTTP/HTTPS proxy settings from environment variables (
http_proxy,https_proxy,HTTP_PROXY,HTTPS_PROXY). The CLI respectsno_proxy/NO_PROXYbypass rules.
Improvements
Enhanced Python Dependency Scanning - Improved Python dependency detection with support for extras notation (e.g.,
openai[aiohttp]>=1.52.2) across requirements.txt, pyproject.toml, anduv treeoutput. The scanner now also automatically falls back topip3whenpipis not available, improving compatibility with macOS and Linux distributions.
Bug Fixes
Fixed Go package PURL validation to require the
vprefix in version strings (e.g.,v1.9.3instead of1.9.3), ensuring pkg.go.dev documentation links work correctly.Fixed false "broken link" warnings during
tessl tile lintwhen markdown files contain URI schemes likemailto:,tel:,ftp:, ordata:.
0.57.0
New Features
Monorepo Subfolder Support - The
tessl install --project-dependenciescommand now scans dependencies from your current working directory, enabling you to run it from monorepo subfolders in an initialized project (e.g.,tessl init && cd backend && tessl install --project-dependencies)
Improvements
Smarter Documentation Tree - The context tool now only includes files that are transitively linked from a tile's documentation entrypoint, filtering out orphaned files and making documentation discovery more focused
Bug Fixes
Fixed markdown link validation to properly handle anchors (e.g.,
./guide.md#section). The validator now validates both file existence and anchor validity, with clearer error messages for broken links
0.56.2
Improvements
Internal - Stability improvements
0.56.1
Improvements
Observability Enhancements - Improved telemetry infrastructure for better diagnostics and system monitoring
0.56.0
Breaking Changes
Node.js 18 No Longer Supported - The CLI now requires Node.js 20 or later. Node.js 18 reached end-of-life in April 2025 and is no longer supported. The CLI will now fail with a clear error message if you attempt to run it on Node.js 18.
Improvements
Only Auto-Init Outside Existing Projects - The
installandsearchcommands no longer automatically initialize a project when run in a subdirectory of a Tessl project directory. This prevents accidentally creating unwanted projects when running commands after changing directories. To initialize a project, explicitly runtessl initfirst.
Bug Fixes
Fixed an issue where the
initcommand's failed to identify and install relevant tiles.
0.55.1
Improvements
Faster Auto-Updates - The CLI now checks for updates every 3 hours (down from 24 hours), ensuring you get critical fixes and improvements more quickly. You can still adjust the interval with
TESSL_AUTO_UPDATE_INTERVAL_MINUTESor disable it by setting it to0.

