wyrd/tools
esc

    ↑↓ Move ↵ Open t3mcp results first Search by Pagefind

    t3mcp

    Releases

    Latest 0.1.4 Release notes on GitHub

    Changelog

    0.1.4

    Fixes
    • Target stock T3 Code 0.1.9, orchestration protocol 2. TARGET_T3_CODE_VERSION is 0.1.9, and t3c version compares the server with 0.1.9.

    0.1.3

    Features
    • Add read-only terminal reads. The library adds TerminalApi.observe, TerminalApi.watchMetadata, TerminalApi.list (every terminal, from the first metadata snapshot) and TerminalApi.read (one terminal snapshot with its retained history), all with terminal:read. t3code-mcp adds thread_terminals, which lists the server terminals of a thread, and terminal_output, which returns the bounded plain-text tail of one terminal’s history with its status and exit details. Neither tool starts, attaches to or writes to a terminal.
    • Add local server reads and stop. The library adds client.localServers (LocalServersApi): list returns one fresh scan of the local servers that the server finds on its host (listeners that it attributes to a thread terminal or a thread’s agent, plus configured URLs that answer as web servers), watch follows changes, both with orchestration:read, and stop({ pid, port }) stops a thread-attributed listener’s process group with terminal:operate. t3code-mcp adds local_servers (optional threadId filter and urls to probe) and stop_local_server, which stops only a listener that the named thread’s agent started and refuses servers in thread terminals with code terminal_owned.
    • Add thread tags. The library adds threads.setTag(threadId, tag, tagged), which sends thread.tag.set and returns the tags read back from the shell, and a tag filter on threads.list. t3code-mcp adds thread_tag and tagged_threads (bounded summaries, default 100, at most 500). t3c adds thread tag <threadId> <tag> [--remove] and thread list --tag <tag>. Tags match by exact spelling and case after trimming; the web client can hide tagged threads.
    • Name tool access kinds. defineTool takes a ToolAccess ("read", "destructive" or "idempotentWrite", now exported as a type) as its last argument and sets the MCP annotations from it; idempotentWrite marks a write that is neither destructive nor different when repeated. true and false still work as "read" and "destructive".
    • Add the read-only tools thread_family and worktree_threads. thread_family returns every active thread with the same root as a thread, in any run state, including forks and idle subagent children. worktree_threads returns the ids of the active threads on a worktree path, so an agent can check a worktree before it removes it.
    • Add read-only server diagnostics. The library adds client.diagnostics (DiagnosticsApi) with traces, processes, hostResources, resourceHistory and storageCleanupReport (the first report stream item, null before the first cleanup). t3code-mcp adds server_traces, server_processes, server_host_resources, server_resource_history and server_storage_cleanup_report. Process lists, the history window and each command line, failure cause and log message are bounded, and Effect Option fields are returned as their value or null. No tool signals a process, runs a cleanup or restarts the resource monitor.
    • Add the thread_force_stop tool. It force stops a thread whose agent ignored Stop, through orchestration.forceStopThread, and returns outcome (killed, released, releasing or shared) and sharedWithThreadIds. With runId, it fails with code superseded and stops nothing when another run is the latest.
    Fixes
    • Target stock T3 Code 0.1.7, orchestration protocol 2. TARGET_T3_CODE_VERSION is 0.1.7, and t3c version compares the server with 0.1.7.
    • Target stock T3 Code 0.1.8, orchestration protocol 2. TARGET_T3_CODE_VERSION is 0.1.8, and t3c version compares the server with 0.1.8.

    0.1.2

    Fixes
    • Add the T3 Code 0.1.6 orchestration reads and force stop: threads.forceStop, shell.threadFamily, shell.worktreeThreadIds, shell.olderSettledThreads. shell.snapshot and shell.watch accept omitIdleSubagents and omitOlderSettled, and snapshots carry olderSettled. threads.search accepts olderSettledBefore, projectIds, environmentLabel and titlesOnly, and its results carry snapshotSequence, threads and match quality, hits and messageId. ServerConfig exposes shellThreadFamilies and shellOlderSettled.
    • Add the browser tab methods preview.open, resize, adjust, close, list, clearProfile, reportProfiles, reportStatus and stopLocalServer, and the streams subscribePreviewEvents and subscribeDiscoveredLocalServers. Add the routes previewStream.download and previewStream.upload, and T3Client.openPreviewViewer for the viewer socket of a tab in the server’s browser. schemas.preview and schemas.previewViewer hold their shapes.
    • Add the provider install methods provider.install.start, provider.install.cancel, provider.install.subscribe and provider.install.remove, and the ACP registry methods server.searchAcpRegistry, server.prepareAcpRegistryAgent, server.uninstallAcpRegistryManagedBinary, server.acceptAcpRegistryUrlAuth, server.listAcpRegistrySessions, server.importAcpRegistrySession, server.deleteAcpRegistrySession, server.listAcpRegistryProviders, server.setAcpRegistryProvider, server.disableAcpRegistryProvider and server.logoutAcpRegistry. schemas.providerInstall and schemas.acpRegistry hold the new types, and AcpRegistryOperationError joins the RPC error record. redactSecrets also removes a whole headers map, and T3RpcError and T3RpcDefectError now keep only a redacted copy of a failure.
    • Add the pull request read methods pullRequests.list, listStats, filterOptions, summary, routing, routingIdentity, stack, linkedThreads, detail, preview, checks, activity, reviewGuide, threadComments, diffFileContents, filesViewed, changeBreakdown, reviewerCandidates, labelCandidates and subscribeRefreshes, and the pullRequests.diff route. schemas.pullRequests holds the new types, and PullRequestUnavailableError and PullRequestOperationError join the RPC error record.
    • Add the workspace methods terminal.clear, terminal.observe, subscribeTerminalMetadata, vcs.init, vcs.pull, git.runStackedAction, git.resolvePullRequest, git.preparePullRequestThread, review.getBranchCommits, review.getDiffPreview and review.getDiffFileContents. subscribeVcsStatus takes includeRemote, local status reports branchChanges, and RpcErrorRecord decodes the Vcs* process failures. schemas.git and schemas.review hold the new types.
    • Add the provider sign-in methods provider.auth.start, provider.auth.respond, provider.auth.complete, provider.auth.cancel, provider.auth.logout, provider.auth.subscribe, provider.chatgpt.reconnect-profile, provider.chatgpt.import-profile and provider.chatgpt.handoff.subscribe, with provider.consumeResetCredit and provider.uploadFeedback. schemas.providerSetup holds the new types. redactSecrets also removes a device code and a URL whose query holds a code or an identity token.
    • Target stock T3 Code 0.1.6. Follow methods the server removed: server.getSettings() reads the settings from the server configuration and scheduledTasks.list() reads the first item of the task subscription, with the same results. ShellApi.watchArchived, TerminalApi.watchEvents, AuthClient.listPairingLinks and AuthClient.listClients are removed because the server no longer serves them: read archived threads with archivedSnapshot, and read pairing links and client sessions from the first watchAccess snapshot.
    • Add projects.createFromThread, which turns a No project thread’s own folder into a project in place. projects.update accepts pinned and archived, and projects carry pinnedAt and archivedAt. Environment capabilities expose threadProjectFromScratch and projectOrganization.
    • Type the orchestration fields of T3 Code 0.1.6. Thread rows expose opens and lineage.sideChat. Turn items expose monitor, unresponsiveAt, idleCompaction, filesTotal, remoteChild and the secret delivery. Subagents expose remoteChild, workflow agents effort and speed, background work awaited, and runtime requests feedback and supportsFeedback. Commands accept stopDelegatedTasks, onlyIfUnused, opened, searchQuery, sideChat and feedback, and threads.respondToApproval accepts feedback. The launch result exposes sequence. payloadBudgetExceeded is removed, because the 0.1.6 server no longer sends it.
    • Add the methods server.updateServer, updateServerWithProgress and commitDesktopUpdate, cloud.getRelayClientStatus and installRelayClient, and the connect.* routes for T3 Connect links. schemas.serverSelfUpdate, schemas.relayClient and schemas.cloudLink hold their shapes.
    • Add the file methods filesystem.browse, filesystem.getMetadata, assets.createUrl, assets.persistChatAttachments, attachments.createUploadUrl, attachments.delete and shell.openInEditor, and the signed routes assets.read (GET /api/assets/*) and attachments.upload (POST /api/attachments/upload/*). assetUrlParams and attachmentUploadUrlParams turn a relativeUrl into route params. schemas.server.EditorId names every editor of the target build.
    • Add the MCP OAuth routes mcpOAuth.protectedResource, mcpProtectedResource, authorizationServer, register, authorize, approval, decision and token. A route with redirectResponse does not follow a redirect, and answers with { location }. schemas.authMcp holds their shapes.
    • Add the settings methods server.updateSettings, server.upsertKeybinding, server.removeKeybinding, server.updateProvider, server.reportClientActivity, server.discoverSourceControl, server.refreshUsageRates and secrets.answerRequest. A settings patch is validated key by key and asks for the scope the server requires. RpcErrorRecord decodes ServerProviderUpdateError and SecretRequestError, and ServerSettingsError no longer needs a cause. schemas.settingsPatch, schemas.providerInstance, schemas.deviceHosts, schemas.serverActions and schemas.sourceControl hold the new types.
    • Add the guest routes guest.redeem, session, submit, stream, render, item, history, commandOutput, attachment and media, and the webhook routes webhooks.webhookPost, webhookPut, webhookPatch and webhookGet. HttpRouteClient.stream reads a route that answers with server-sent events, and a route input can carry headers. webhookUrlParams reads the params of a webhook endpoint, and schemas.orchestrationGuestStream holds the shapes of a guest stream.
    • Add client.guestShares with create, close, sendMessage and dismissMessage. Thread records expose guestShare, shell rows expose pendingGuestMessageCount, message context exposes guest, thread events include thread.guest-share-updated, commands include thread.guest-share.close and thread.guest-message.dismiss, message.dispatch takes guestMessageId, and RpcErrorRecord includes GuestShareCreateError.
    • Add client.peerLinks with list, link, unlink and answerRequest. Thread rows expose linkOrigin and delegatedFrom, turn items include link_request, environment capabilities expose peerLinks, mcpModeLimitHeader and linkFence, and RpcErrorRecord includes PeerLinkError and PeerLinkRequestError.
    • Add client.routes, a typed entry for each HTTP route by name, with POST /api/auth/browser-session, POST /api/auth/websocket-ticket/:use, POST /api/projects/mutate and GET /api/orchestration/threads/:threadId/bounded. exchangePairingToken and setAccessToken accept dpopKey for a session bound to a DPoP key: generateDpopKey makes the key, the credential store keeps it with the token, and every request and socket upgrade carries a proof. currentDesktopBootstrapToken derives the token of a desktop bootstrap secret. T3ClientOptions.fetchAuthenticates lets a fetch with a cookie jar carry a browser session. ThreadHistoryPageOptions.view accepts work.
    • Type the server field changes of T3 Code 0.1.6. Environment capabilities expose sideChats, threadForceStop, localServerStop and desktopAppChannelSwitch, and the descriptor exposes databaseMigration. The server configuration exposes secretProviderSettings, secretReferences, and the source and variable of each OTLP endpoint. Terminal snapshots and activity events expose cols and rows, pull request watches expose owedChecks and checksAwaitedSince, and message context has an environment record. GitCommandError has the config_locked reason, and usage has the muse provider. reasoningMessages and requiresNewThreadForModelChange are removed, because the 0.1.6 server no longer sends them.
    • Add server.getNpmRelease and server.prepareTriage. server.refreshProviders accepts reloadSecrets, workspaceSnapshotsOnDemand and usageLimitsCommand, server.watchConfig accepts usageLimitsCommand and workspaceSnapshotsOnDemand, and vcs.status accepts localOnly. Environment capabilities expose npmReleaseLookup, triage and providerWorkspaceSnapshotsOnDemand.
    • Add the diagnostics methods server.getTraceDiagnostics, server.getProcessDiagnostics, server.getHostResources, server.getProcessResourceHistory, server.getResourceTelemetryHistory, server.retryResourceTelemetry, server.checkOtlpEndpoint, server.signalProcess, server.runStorageCleanup, server.getStorageCleanupReport and subscribeResourceTelemetry. schemas.diagnostics, schemas.resourceTelemetry and schemas.storageCleanup hold the new types.
    • Add the source control methods sourceControl.lookupRepository, sourceControl.cloneRepository, sourceControl.publishRepository, sourceControl.signInStart, sourceControl.signInWait, sourceControl.signInCancel, sourceControl.appAccess and sourceControl.starred, the tracked clone methods projectClone.start, projectClone.cancel, projectClone.retry and subscribeProjectClones, and the agent session methods agentSessions.scan and agentSessions.import. schemas.projectClone and schemas.agentSessions hold the new types, and the failures of these methods join the RPC error record. redactSecrets also removes a string that holds a URL with a credential, and it reads strings in arrays.
    • Add the pull request write methods pullRequests.setFilesViewed, runAction, update, comment, updateComment, submitReview, replyToThread, setThreadResolution, setReaction, requestReviewers and setLabels, the review guide run pullRequests.generateReviewGuide, and pullRequests.invalidate and reportState. schemas.pullRequests holds their inputs.
    • Add the device methods device.list, configure, testHost, easAccount, simlockIdentity, open, close, shutdown, detail and action, and the stream subscribeDeviceState. schemas.device holds their shapes, and schemas.rpcErrors their failures.

    0.1.1

    Fixes
    • Publish the complementary MCP server and its setup documentation under an available npm version.

    0.1.0

    Features
    • Provide the t3code-mcp stdio MCP server, complementing stock T3 Code MCP with scheduled task endpoints, webhook rotation and deliveries, execution configuration, thread status, approvals, usage, diffs and in-thread search, provider status and usage summaries through shared t3c profiles. Include native thread Stop, queue Resume and selected queued-message Start. Resume and selected Start clear the hold on all queued runs; other messages may follow.