Coders Talk

After the user chooses a task to continue, attach the actual current session to it. Use the client and session ID from the local plugin context, never guess IDs. Pass continues: the session_id (from get_task_context) of the session you are continuing, usually the latest one you read; your session then goes on in that session's draft, so one Build shows the work of both agents. This records a private link; it does not upload or publish history.

KeepPlain library: find moments where coding agents failed on a similar problem and what the human did about it. Use after two or three failed attempts at the same problem. Query: the symptom or error message in a few words, without paths or secrets.

KeepPlain: step 2 of sending the current coding session, after the KeepPlain skill's upload step put it at the link from start_session_upload. Makes a private draft (or the team's, as the preview said) and returns its link. Nothing is published: the user reviews the draft on KeepPlain.

KeepPlain library: read one published session found with search_coding_agent_sessions or find_coding_agent_failures. detail "brief" (default): the goal, the first prompt, the outcome, the whole verdict and the numbers. detail "moments": every moment in order, with the prompts that worked, where the agent failed and why the human stepped in.

Read more turns from an accessible private work session. Use session_id returned by get_task_context and cursor to page through the source, or a matched session's excerpt from search_my_work: its cursor, limit 1 and its text_offset read the passage found and on from it.

Read private task context after selecting a task. Returns source excerpts without a paid summary call. Check the actual checkout before continuing. Fetch more session turns if excerpts are insufficient.

Your team's pieces of work on KeepPlain, grouped from its members' agent sessions: title, task number, project, when it was last worked on, and its latest sessions (open one with get_coding_agent_session). Use when picking up work a teammate started, or to see what is going on in a project. Only for tokens of a team member.

KeepPlain library: find published sessions where developers did a similar task with a coding agent. Use before a non-trivial task on a known stack, or when the user asks how others did something; skip small edits and questions about this repository. Returns up to 5 cards with the outcome, how long it took and how often the human had to step in. Query: the task in a few words, e.g. "migrate queues to horizon". An empty result means nobody has published such a session yet.

Find your own or team tasks, and where in their sessions the words are. For continuing work, get the current repository key from the local plugin at query time and search that project first. Query: two to four key words of the work. Russian and English word forms match ("выпускал сертификат", "issued certificates"), translations do not: session titles are in English, so add the English terms to the user's words. Tasks come best match first (a title match outranks a word in a session, words found together outrank scattered ones), newest among equals. matched_sessions names the sessions the words were found in; a session's excerpt quotes the passage, and its cursor and text_offset go straight to get_session_excerpt. words_matched all_but_one: no task held every word, these miss one; none: the query held only stop words, the tasks are the newest. Why was this changed, or where did this code come from: pass paths (repository-relative, as git names them) or a commit sha from git blame or log, with agent_sessions, the values of that commit's Agent-Session trailer, and subject, the first line of its message; query may then be empty. A commit or a trailer finds its sessions in every repository (scope all), since an agent may have committed in another repository than its folder's: found_by says how, agent_session (the trailer names it), commit (its memory holds it) or team_commit (the team's repository puts it to it). Each matched session's change then gives the turn (cursor) where it changed the file or made the commit, and request, the person's last real request before it (short replies such as "yes" skipped): read from request.cursor to cursor with get_session_excerpt. own: true when the session made the change itself (its agent's edit or a git commit it ran), false when it only saw it in its git snapshots, as another session working in the same folder does; those that made it come first. found_by agent_session without a cursor: the trailer alone, which the hook writes into a commit made by hand too, for every session whose edits it holds, so it is not own; own comes from the session's git commit of that title (give subject) or its own edits of paths. op outside on a commit: the commit was made outside the session (by hand, a client's button) of files its agent edited; cursor is the agent's last edit of them before it. found_by edits_before: nothing names the commit (made by hand after the session, no trailer), and this session's agent last edited its files before it (give committed_at where the team's repository is not under the GitHub App): its work, not proven its commit; say so. closed_sessions: a teammate's session behind the change that you may not read (your team shows its members each other's sessions, their transcripts only to owners and admins): say whose it is and give its page, and that its author or an admin can tell more; nothing of it is returned. Offer the matching tasks when there are several; never silently broaden a repository search. No model generation.

KeepPlain: step 1 of sending the current coding session to the user's KeepPlain drafts, for the KeepPlain skill or plugin only. Call it only after the user asked to send this session and agreed to what the skill's preview showed. Returns a one-time upload link (15 minutes) for the skill's upload step, and an upload_id for finish_session_upload. Never put anything else at the link.