surshar / claude-code

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

Built by Anthropic · github.com/anthropics

mods/diff: the docked pane draws as the built-in panel does (every file's hunks under an eight-row list, rows that scroll to their file, no focus or close mark of its own, /diff's transcript line) and the inline pane as its dialogBrowse files

		@@ -1,16 +1,19 @@
1	1	# diff
2	2
3	3	The diff pane as a plugin: `/diff` opens the session's uncommitted changes
4		-beside the transcript, one row per changed file and the selected file's
5		-hunks beneath, and closes it again. The pane refreshes as Claude edits,
6		-runs shell commands and finishes turns, and while it is open it polls the
7		-repository's HEAD so a commit or checkout made elsewhere shows too. The
8		-first successful edit of a session opens the pane by itself where the
9		-terminal is wide enough (144 columns when the person never chose, 110 when
10		-they kept it open before; a person who closed it is left alone). On a
11		-terminal under 110 columns `/diff` answers with the built-in's line asking
12		-for a wider terminal and opens nothing; a pane opened wider that the surface
13		-then seats inline shows only that line. A file's
	4	+beside the transcript, one row per changed file and every file's hunks
	5	+beneath, a row's click scrolling to its file, and closes it again; each
	6	+toggle leaves `Diff panel shown` or `Diff panel hidden` in the transcript.
	7	+The pane refreshes as Claude edits, runs shell commands and finishes turns,
	8	+and while it is open it polls the repository's HEAD so a commit or checkout
	9	+made elsewhere shows too. The first successful edit of a session opens the
	10	+pane by itself where the terminal is wide enough (144 columns when the
	11	+person never chose, 110 when they kept it open before; a person who closed
	12	+it is left alone). On a terminal under 110 columns `/diff` answers with the
	13	+built-in's line asking for a wider terminal and opens nothing; a pane the
	14	+surface seats inline on a terminal that wide shows only that line, and on a
	15	+wider one (a session without the fullscreen layout) the built-in dialog's
	16	+layout: the rows round the selected file and that file's hunks. A file's
14	17	ask button arms that file: its hunks ride the next prompt as context, once.
15	18
16	19	The pane compares the working tree against HEAD, split at the session's
		@@ -18,9 +21,10 @@
18	21	the default branch; the choice is kept per repository in the plugin's
19	22	store. A second picker shows one earlier turn's edits instead of the
20	23	working tree, read from the session's messages. Files that changed before
21		-the session started, and noise (lockfiles, generated and test files), are
22		-listed apart and folded until asked for. Outside a git repository `/diff`
23		-says so and does nothing else.
	24	+the session started (by their timestamp, among the paths already dirty at
	25	+the start), and noise (lockfiles, generated and test files), are listed
	26	+apart and folded until asked for; a rename lists as git prints it. Outside
	27	+a git repository `/diff` says so and does nothing else.
24	28
25	29	`hooks/register.ts` is the module; everything under `hooks/` is its parts.
26	30
		@@ -30,8 +34,9 @@
30	34	\| --- \| --- \|
31	35	\| `session.start` \| Binds the engine once, registers `/diff` (a session where another `/diff` is listed leaves the plugin idle), and pins the repository. \|
32	36	\| `ui.render` of `PromptHint` \| Reads the terminal's width, which decides whether the first edit opens the pane. \|
33		-\| `ui.render` of `Pane` \| Draws the pane: header, the file list, the toggles, the base and source pickers, and the selected file's hunks. \|
34		-\| `command.run` of `diff` \| Opens or closes the pane and remembers the choice. \|
	37	+\| `ui.render` of `Pane` \| Draws the pane: header, the base and source pickers, the file list, the toggles, and the files' hunks. \|
	38	+\| `command.run` of `diff` \| Opens or closes the pane, says which, and remembers the choice. \|
	39	+\| `ui.close` of the pane \| Remembers the person's close as `/diff`'s. \|
35	40	\| `command.run` of `clear`, `resume` \| Closes the pane and forgets the session's state. \|
36	41	\| `tool.call` of `Edit`, `Write`, `NotebookEdit` \| After the edit, refreshes an open pane; the session's first successful edit opens it. \|
37	42	\| `tool.call` of `Bash`, `PowerShell` \| After the command, refreshes an open pane. \|
		@@ -40,10 +45,10 @@
40	45
41	46	## What it calls on `$`
42	47
43		-`clock.after`, `clock.every`, `clock.now`, `clock.sleep`, `command.register`,
44		-`fs.list`, `fs.read`, `fs.stat`, `process.run` (git, read-only), `session.messages`,
	48	+`clock.after`, `clock.every`, `clock.now`, `command.register`, `fs.list`,
	49	+`fs.read`, `fs.stat`, `process.run` (git, read-only), `session.messages`,
45	50	`store.get`, `store.set`, `telemetry.log`, `telemetry.mark`, `ui.close`,
46		-`ui.invalidate`, `ui.log`, `ui.open`, `ui.resolve`, `ui.status`.
	51	+`ui.invalidate`, `ui.log`, `ui.open`, `ui.resolve`, `ui.scroll`, `ui.status`.
47	52
48	53	`$.telemetry` is the telemetry plugin's noun; where it is absent the rows
49	54	are dropped and nothing else changes.

		@@ -1,0 +1,31 @@
	1	+import type Git from '../git'
	2	+import Limits from '../limits'
	3	+import PaneState from '../pane-state'
	4	+
	5	+/**
	6	+ * The files whose bodies the pane draws now, in drawing order: the listed
	7	+ * session rows, then the pre-session rows while their section is open.
	8	+ *
	9	+ * Past PRE_SESSION_BODY_CAP pre-session files only their legend shows, so
	10	+ * none of their bodies is wanted.
	11	+ *
	12	+ * @param model the pane's state: its fetch and its two toggles
	13	+ * @returns the rows, none without a fetch
	14	+ */
	15	+export function drawnFilesOf(
	16	+ model: Pick<
	17	+ PaneState.PaneModel,
	18	+ 'data' \| 'isNoiseShown' \| 'isPreSessionShown'
	19	+ >,
	20	+): readonly Git.FileStat[] {
	21	+ const partition = PaneState.partitionOf(
	22	+ model.data?.files ?? [],
	23	+ model.isNoiseShown ? 'shown' : 'hidden',
	24	+ )
	25	+
	26	+ const isBodied =
	27	+ model.isPreSessionShown &&
	28	+ partition.preSession.length <= Limits.PRE_SESSION_BODY_CAP
	29	+
	30	+ return [...partition.shown, ...(isBodied ? partition.preSession : [])]
	31	+}

		@@ -1,0 +1,3 @@
	1	+export * from './drawn-files-of.js'
	2	+
	3	+export * as default from '.'

		@@ -9,6 +9,7 @@
9	9	ProcessRunResult,
10	10	SessionMessage,
11	11	TimerCall,
	12	+ UiScrollResult,
12	13	} from 'claude-code'
13	14
14	15	/**
		@@ -32,11 +33,6 @@
32	33	every: TimerCall
33	34
34	35	/**
35		- * `$.clock.sleep`, no signal.
36		- */
37		- sleep: (ms: number) => Promise<void>
38		-
39		- /**
40	36	* `$.process.run`.
41	37	*/
42	38	run: (
		@@ -100,6 +96,12 @@
100	96	closePane: (pane: PaneCloseArgs) => Promise<void>
101	97
102	98	/**
	99	+ * `$.ui.scroll` to one of the pane's own keyed elements, its top at the
	100	+ * window's top.
	101	+ */
	102	+ scrollTo: (key: string) => Promise<UiScrollResult>
	103	+
	104	+ /**
103	105	* `$.command.register`; rejects while another `/diff` is listed.
104	106	*/
105	107	registerCommand: (spec: CommandSpec) => Promise<unknown>

		@@ -4,12 +4,15 @@
4	4	export * from './classify'
5	5	export * from './command-spec'
6	6	export * from './count-of'
	7	+export * from './drawn-files-of'
7	8	export * from './entry-kinds-of'
8	9	export * from './git'
9	10	export * from './host'
10	11	export * from './is-on-pane-surface'
11	12	export * from './is-record'
	13	+export * from './kept-of'
12	14	export * from './limits'
	15	+export * from './map-limited'
13	16	export * from './message-of'
14	17	export * from './mtime-of'
15	18	export * from './names'

		@@ -1,0 +1,3 @@
	1	+export * from './kept-of.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,9 @@
	1	+/**
	2	+ * The items that are there: nulls dropped, so a part may answer null for
	3	+ * "nothing here" and the whole lists what is left.
	4	+ *
	5	+ * @param items values or nulls
	6	+ * @returns the values, in order
	7	+ */
	8	+export const keptOf = <T>(items: readonly (T \| null)[]): T[] =>
	9	+ items.filter((item): item is T => item !== null)

		@@ -4,7 +4,7 @@
4	4	export * from './max-lines-per-file.js'
5	5	export * from './max-listed-directories.js'
6	6	export * from './max-untracked-probes.js'
7		-export * from './pane-top-pad-rows.js'
	7	+export * from './pane'
8	8	export * from './prompt-context-max-chars.js'
9	9
10	10	export * as default from '.'

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * How many files' hunks are read from the backend at once while the pane
	3	+ * loads its bodies.
	4	+ */
	5	+export const BODY_FETCH_CONCURRENCY = 6

		@@ -1,0 +1,7 @@
	1	+export * from './body-fetch-concurrency.js'
	2	+export * from './max-dialog-rows.js'
	3	+export * from './max-summary-rows.js'
	4	+export * from './pane-top-pad-rows.js'
	5	+export * from './pre-session-body-cap.js'
	6	+
	7	+export * as default from '.'

		@@ -1,0 +1,30 @@
	1	+/**
	2	+ * Maps every item through an async function, a bounded number of them in
	3	+ * flight at once, and resolves to the results in the items' order.
	4	+ *
	5	+ * @param items the inputs
	6	+ * @param limit how many may run at once, at least one
	7	+ * @param fn the work for one item
	8	+ * @returns the results, in order
	9	+ */
	10	+export async function mapLimited<T, R>(
	11	+ items: readonly T[],
	12	+ limit: number,
	13	+ fn: (item: T) => Promise<R>,
	14	+): Promise<R[]> {
	15	+ const results: R[] = []
	16	+
	17	+ let next = 0
	18	+
	19	+ async function worker(): Promise<void> {
	20	+ for (let at = next++; at < items.length; at = next++) {
	21	+ results[at] = await fn(items[at] as T)
	22	+ }
	23	+ }
	24	+
	25	+ await Promise.all(
	26	+ Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, worker),
	27	+ )
	28	+
	29	+ return results
	30	+}

		@@ -1,9 +1,0 @@
1		-import type { PaneOpenArgs } from 'claude-code'
2		-
3		-/**
4		- * The part of `$.ui.open`'s argument that asks the surface for the
5		- * person's keyboard: what `/diff` adds and the first-edit open leaves out.
6		- */
7		-export const FOCUSED_PANE: Pick<PaneOpenArgs, 'focus'> = Object.freeze({
8		- focus: true,
9		-})

		@@ -1,14 +1,14 @@
1		-import type Backend from '../../backend'
	1	+import type PaneState from '../../pane-state'
2	2
3	3	/**
4	4	* The pane's word for a fetch whose untracked listing the backend did not
5	5	* give whole: the tracked rows stand, the new files are not counted.
6	6	*
7		- * @param words the backend's words, naming the program that lists them
	7	+ * @param model the pane's state, its words naming the program that lists them
8	8	* @returns the note
9	9	*/
10	10	export const untrackedWithheldTextOf = (
11		- words: Pick<Backend.BackendWords, 'lister'>,
	11	+ model: Pick<PaneState.PaneModel, 'words'>,
12	12	) =>
13		- `Untracked files unavailable (${words.lister} could not list them); ` +
	13	+ `Untracked files unavailable (${model.words.lister} could not list them); ` +
14	14	'not counted'

		@@ -1,11 +1,12 @@
	1	+import { NO_BODIES } from '../../no-bodies'
	2	+
1	3	/**
2	4	* What `/clear` and `/resume` reset: the pick, the source, the turns and
3		- * the body; the fetch itself stays.
	5	+ * the bodies; the fetch itself stays.
4	6	*/
5	7	export const NEW_SESSION_FIELDS = Object.freeze({
6	8	selectedPath: null,
7	9	source: Object.freeze({ kind: 'current' }),
8	10	turns: Object.freeze([]),
9		- body: null,
10		- bodyState: 'idle',
	11	+ bodies: NO_BODIES,
11	12	} as const)

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * How many file rows the inline pane's list shows at once, around the
	3	+ * selected one (the built-in dialog's window).
	4	+ */
	5	+export const MAX_DIALOG_ROWS = 5

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * How many file rows the docked pane's list shows at once (the built-in
	3	+ * panel's window); the rest are counted on a dim row under them.
	4	+ */
	5	+export const MAX_SUMMARY_ROWS = 8

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * The blank row the docked pane keeps above its header, as the built-in
	3	+ * sidebar's header does (its `paddingY`).
	4	+ */
	5	+export const PANE_TOP_PAD_ROWS = 1

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * How many pre-session files get their bodies drawn once that section is
	3	+ * open (the built-in panel's cap); past it only their legend is listed.
	4	+ */
	5	+export const PRE_SESSION_BODY_CAP = 20

		@@ -1,5 +1,0 @@
1		-/**
2		- * The blank row the docked pane keeps above its header, as the built-in
3		- * sidebar's header does (its `paddingY`).
4		- */
5		-export const PANE_TOP_PAD_ROWS = 1

		@@ -1,6 +1,5 @@
1	1	export * from './git-timeout-ms.js'
2	2	export * from './head-poll-ms.js'
3		-export * from './open-probe-ms.js'
4	3	export * from './redraw-coalesce-ms.js'
5	4	export * from './refresh-debounce-ms.js'
6	5

		@@ -1,5 +1,0 @@
1		-/**
2		- * How long `/diff` waits for the pane to draw after an invalidate before it
3		- * takes the pane as closed by the person and opens it again.
4		- */
5		-export const OPEN_PROBE_MS = 120

		@@ -1,0 +1,3 @@
	1	+export * from './map-limited.js'
	2	+
	3	+export * as default from '.'

		@@ -1,3 +1,0 @@
1		-export * from './focused-pane.js'
2		-
3		-export * as default from '.'

		@@ -1,6 +1,5 @@
1	1	export * from './command-description.js'
2	2	export * from './command-name.js'
3		-export * from './focused-pane'
4	3	export * from './keys'
5	4	export * from './pane-id.js'
6	5	export * from './pane-title.js'

		@@ -1,6 +1,7 @@
1	1	export * from './builtin-holds-pattern.js'
2	2	export * from './git-unanswered-text.js'
3	3	export * from './not-in-repository-text.js'
	4	+export * from './panel-toggle'
4	5	export * from './register-failed-text-of.js'
5	6	export * from './resize-terminal-text.js'
6	7	export * from './untracked-withheld-text-of.js'

		@@ -1,0 +1,4 @@
	1	+export * from './panel-hidden-text.js'
	2	+export * from './panel-shown-text.js'
	3	+
	4	+export * as default from '.'

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * `/diff`'s transcript line once it closed the pane, worded as the built-in
	3	+ * words its own.
	4	+ */
	5	+export const PANEL_HIDDEN_TEXT = 'Diff panel hidden'

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * `/diff`'s transcript line once it opened the pane, worded as the built-in
	3	+ * words its own.
	4	+ */
	5	+export const PANEL_SHOWN_TEXT = 'Diff panel shown'

		@@ -1,44 +1,0 @@
1		-import { modeLabelOf } from './mode-label-of'
2		-import type { PaneModel } from './pane-model'
3		-
4		-/**
5		- * The dim line under the header naming what the diff compares against
6		- * (ReplDiffSidebar diffBaseLabel), or null for none.
7		- *
8		- * Hidden in settled session mode and before any fetch; the requested mode
9		- * with an ellipsis while its fetch is pending; on an unborn HEAD with
10		- * rows, what the rows are instead.
11		- *
12		- * @param model the mode the person picked, the last good fetch, and the
13		- * backend's words
14		- * @param filesCount the header's session file count
15		- * @returns the line, or null
16		- */
17		-export function baseLabelOf(
18		- model: Pick<PaneModel, 'requestedMode' \| 'data' \| 'words'>,
19		- filesCount: number,
20		-): string \| null {
21		- const { requestedMode, data } = model
22		-
23		- if (!data) {
24		- return null
25		- }
26		-
27		- if (data.isUnborn) {
28		- const hasRows = filesCount > 0
29		-
30		- return hasRows ? 'no commits yet — showing staged and new files' : null
31		- }
32		-
33		- const isPending = requestedMode !== data.mode
34		- const isSettledSession = !isPending && requestedMode === 'session'
35		-
36		- if (isSettledSession) {
37		- return null
38		- }
39		-
40		- const phase = isPending ? 'pending' : 'settled'
41		- const label = modeLabelOf(model, data.source, phase)
42		-
43		- return isPending ? `${label}…` : label
44		-}

		@@ -1,0 +1,7 @@
	1	+import type Git from '../../git'
	2	+
	3	+/**
	4	+ * The file bodies the pane has read, by path: the parsed hunks, or null
	5	+ * where the backend could not read them; a path not in it is still loading.
	6	+ */
	7	+export type Bodies = ReadonlyMap<string, Git.FileHunks \| null>

		@@ -1,0 +1,3 @@
	1	+export type * from './bodies.js'
	2	+
	3	+export * as default from '.'

		@@ -1,5 +1,0 @@
1		-/**
2		- * Where the selected file's body stands: nothing selected, being read, git
3		- * could not read it, or in hand.
4		- */
5		-export type BodyState = 'idle' \| 'loading' \| 'failed' \| 'ready'

		@@ -1,3 +1,0 @@
1		-export type * from './body-state.js'
2		-
3		-export * as default from '.'

		@@ -1,0 +1,8 @@
	1	+/**
	2	+ * The inline pane's first line, as the built-in dialog heads itself: what
	3	+ * the rows are, then in dim what they are compared with.
	4	+ */
	5	+export type DialogTitle = {
	6	+ title: string
	7	+ subtitle: string
	8	+}