file-links

1import { atom, read, update } from 'claude-code'
2import type { Register } from 'claude-code'
3
4const PANE = 'file-links'
5const files = atom({ plugin: 'file-links', key: 'files' } as const, [] as string[])
6const query = atom({ plugin: 'file-links', key: 'query' } as const, '')
7
8const toWindows = (path: string) =>
9  path.replace(/^\/([a-zA-Z])\//, '$1:/').replace(/\//g, '\\')
10const split = (path: string) => {
11  const cut = Math.max(path.lastIndexOf('\\'), path.lastIndexOf('/'))
12  return { name: path.slice(cut + 1), dir: path.slice(0, Math.max(cut, 0)) }
13}
14
15const TOKEN = /(?:"([^"]+)"|'([^']+)'|([^\s"'|&;<>()]+))/g
16const dirOf = (p: string) => {
17  const cut = Math.max(p.lastIndexOf('\\'), p.lastIndexOf('/'))
18  return cut > 0 ? p.slice(0, cut) : undefined
19}
20const candidates = (command: string) => {
21  const out = new Set<string>()
22  for (const m of command.matchAll(TOKEN)) {
23    const t = m[1] ?? m[2] ?? m[3]
24    if (t && /\.[A-Za-z0-9]{1,5}$/.test(t) && !t.startsWith('-') && !/^https?:/.test(t)) out.add(t)
25  }
26  return [...out]
27}
28
29const absolute = async ($: any, path: string) => {
30  if (/^([a-zA-Z]:|\/|\\)/.test(path)) return path
31  const stat = await $.fs.stat(path, { resolve: true }).catch(() => undefined)
32  return stat?.realPath ?? path
33}
34
35const track = async ($: any, path: string | undefined) => {
36  if (!path) return
37  const full = toWindows(path)
38  await update($, files, list => [full, ...list.filter(one => one !== full)].slice(0, 200))
39}
40
41export const register: Register = on => {
42  on('session.start', async ($, e, next) => {
43    await $.command.register({ name: 'file-links', description: 'Show files made this session, with links to File Explorer' })
44    void $.ui.open({ id: PANE, title: 'Files' })
45    return next(e)
46  })
47
48  on('command.run', { command: 'file-links' }, async $ => {
49    await $.ui.open({ id: PANE, title: 'Files' })
50    return { text: 'Files pane opened.' }
51  })
52
53  on('tool.call', { tool: 'Write' }, async ($, e, next) => {
54    const ran = await next(e)
55    if (ran.deny === undefined && ran.isError !== true) await track($, e.file_path)
56    return ran
57  }).catch(($, e, next) => next(e))
58
59  on('tool.call', { tool: 'Edit' }, async ($, e, next) => {
60    const ran = await next(e)
61    if (ran.deny === undefined && ran.isError !== true) await track($, e.file_path)
62    return ran
63  }).catch(($, e, next) => next(e))
64
65  on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
66    const t0 = (await $.clock.now()) - 1000
67    const tokens = candidates(e.command)
68    const ran = await next(e)
69    if (ran.deny !== undefined) return ran
70
71    const found = new Set<string>()
72    const dirs = new Set<string>([''])
73    for (const tok of tokens) {
74      const stat = await $.fs.stat(tok).catch(() => undefined)
75      if (stat?.kind === 'file' && stat.mtimeMs >= t0) found.add(tok)
76      const d = dirOf(tok)
77      if (d) dirs.add(d)
78    }
79    for (const m of e.command.matchAll(TOKEN)) {
80      const t = m[1] ?? m[2] ?? m[3]
81      if (!t || t.startsWith('-') || /^https?:/.test(t) || /[*?%]/.test(t)) continue
82      const stat = await $.fs.stat(t).catch(() => undefined)
83      if (stat?.kind === 'dir') dirs.add(t)
84    }
85    for (const d of [...dirs].slice(0, 10)) {
86      const top = await $.fs.list(d || undefined).catch(() => [])
87      for (const sub of top.filter(x => x.kind === 'dir').slice(0, 40)) {
88        dirs.add(d ? `${d}/${sub.name}` : sub.name)
89      }
90    }
91    for (const d of dirs) {
92      const entries = await $.fs.list(d || undefined).catch(() => [])
93      for (const f of entries) {
94        if (f.kind === 'file' && f.mtimeMs >= t0) found.add(d ? `${d}/${f.name}` : f.name)
95      }
96    }
97    for (const path of [...found].slice(0, 30)) await track($, await absolute($, path))
98    return ran
99  }).catch(($, e, next) => next(e))
100
101  on('tool.call', { tool: 'NotebookEdit' }, async ($, e, next) => {
102    const ran = await next(e)
103    if (ran.deny === undefined && ran.isError !== true) await track($, (e as any).notebook_path)
104    return ran
105  }).catch(($, e, next) => next(e))
106
107  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
108    const els = $.ui.resolve(e)
109    const { Box, Text, Button } = els
110    const Input = (els as any).Input as ((props: any) => any) | undefined
111    const all = await read($, files)
112    const q = await read($, query)
113    const needle = q.trim().toLowerCase()
114    const list = needle ? all.filter(path => path.toLowerCase().includes(needle)) : all
115
116    return (
117      <Box flexDirection="column">
118        {Input && (
119          <Input
120            key="search"
121            placeholder="Search files by name"
122            value={q}
123            onInput={(value: string) => {
124              void update($, query, () => value)
125            }}
126            onSubmit={(value: string) => {
127              void update($, query, () => value)
128            }}
129          />
130        )}
131        {all.length === 0 && <Text dimColor>No files yet this session.</Text>}
132        {all.length > 0 && list.length === 0 && <Text dimColor>No file matches "{q}".</Text>}
133        {list.map(path => {
134          const { name, dir } = split(path)
135          return (
136            <Box key={path} flexDirection="column">
137              <Button
138                key={path}
139                onPress={() => {
140                  void $.process.run(['explorer.exe', `/select,${path}`])
141                }}
142              >
143                {name}
144              </Button>
145              <Text dimColor>{dir}</Text>
146            </Box>
147          )
148        })}
149      </Box>
150    )
151  })
152}
153

1declare module 'claude-code' {
2  interface PluginState {
3    'file-links': { files: string[]; query: string }
4  }
5}
6
7export type FileLinksFiles = string[]
8