sidelight

终端分屏只读项目信息总览TUI工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:sidelight。
它的用途是:终端分屏只读项目信息总览TUI工具
完整的 Skill 内容见:https://321skill.com/skills/sidelight/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我在当前项目里找到所有使用`useEffect`的React组件文件。”,AI可以引导你使用Sidelight的搜索功能,在侧边面板中快速列出结果并高亮显示,你无需离开终端即可浏览和预览这些文件。

介绍

Sidelight是一款专为终端分屏设计的只读、项目感知型TUI(文本用户界面)工具。它旨在解决开发者在单一终端窗口内需要频繁切换上下文,查看项目文件、Git状态、搜索结果及代码预览的痛点,通过一个整合的侧边面板提供一站式项目概览,提升编码专注度与效率。

使用时,开发者只需在终端中运行Sidelight,它便会自动识别当前目录的项目结构,并在一个固定的分屏面板中展示文件树、Git分支与状态、实时搜索结果,以及选中文件的代码预览。它支持与可选的AI编程会话元数据集成,但核心功能保持只读,确保界面简洁且不干扰主工作区。

该工具非常适合需要长时间在终端内工作、追求高效工作流且希望减少窗口切换的开发者,尤其是使用Vim、Neovim、Emacs等终端编辑器或Tmux等终端复用器的用户。对于从事全栈开发、系统运维或进行代码审查的工程师而言,它能显著减少上下文切换成本。

建议将Sidelight作为终端工作区的常驻信息面板使用。请注意,它是一个只读工具,不提供文件编辑功能,主要作为信息展示和导航的辅助。初次使用可能需要短暂适应其分屏布局,但一旦集成到工作流中,能有效提升对项目全局的掌控力。

核心特点

与同类终端TUI工具(如Lazygit、Ranger)相比,Sidelight的核心区别在于其专为终端分屏场景设计,提供固定、整合的只读项目视图(文件、Git、搜索、预览一体化),而非一个全功能的交互式文件管理器或Git客户端,更侧重于无干扰的信息展示。

注意事项

不适合需要直接编辑文件、执行复杂Git操作或使用图形化界面的场景。

常见问题

Sidelight能编辑文件吗?

不能,它是一个只读的TUI工具,仅用于查看和导航。

Sidelight支持哪些终端?

支持大多数现代终端模拟器,如iTerm2, Kitty, Alacritty等。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/sidelight/raw/index.md 读取 sidelight 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。