基础使用
快速上手 Kerminal 的日常操作
如何唤醒 Kerminal？
在终端中输入以下命令即可唤醒：
#启动交互式模式
kerminalExec 模式：直接在终端获取结果
# 示例：在受信任的 Git 仓库中直接执行
kerminal exec "帮我输出今日总结"
# 示例：在非 Git 目录（如家目录）中强制执行
kerminal exec "帮我输出今日总结" --skip-git-repo-check恢复历史对话
Kerminal 可以恢复历史对话
方式一
已唤醒 Kerminal 的情况下，在 Kerminal 内输入 /resume，默认展示当前路径的历史对话。
方式二
在终端内输入以下命令：
# 显示当前路径的历史对话
kerminal resume
# 恢复最近的对话
kerminal resume --last
# 查看全部历史对话
kerminal resume --all在 resume 页面下：
- 可查看对话的创建时间、更新时间、当前对话的首个 prompt、所在的
git branch - 支持模糊检索历史对话中首句prompt的内容
- 点击
Tab键，可按照创建对话时间或更新时间进行排序 Ctrl + D两次可以删除选中的历史对话- 支持展示完整的历史记录，包括工具调用等历史
- 通过
resume --all进入非当前路径的 session 会话时，可选择保留当前路径或返回原有路径
Kerminal 支持选项操作
Kerminal 在对话过程中，支持单选、多选、及题目切换操作：
单选操作
- 可通过方向键上下切换选项，或通过输入数字直接进行选项选择
- 按
Enter确认选择； - 如需取消，可按
Esc退出。
多选操作
- 可通过方向键上下切换选项。
- 按
Enter确认当前选择，支持多选。
切换题目/提交
- 当前步骤选好后，按
→进入下一步，按←可返回修改。
- 进入
Submit后，按Enter提交；如需退出，按Esc。
如何升级版本
请在终端内输入以下指令，可自动升级至最新版本；或退出终端，重启可直接自动更新
# 自动检查当前版本并升级至最新版本
kerminal updateKerminal 如何复制图片
方式一
- 复制：
Ctrl + C/Cmd + C - 粘贴：
Ctrl + V/Cmd + V
方式二
Cmd + Shift + 4，截图会自动保存在桌面，拖拽截图至 Kerminal（Mac 电脑）。
方式三
输入 @ 后它会搜索当前目录下的文件来匹配，选择您需要的文件。
方式四
直接把图片的路径复制进去，例如 /Users/Juno/Desktop/Test.png。
Kerminal 的配置放在哪?
全局配置
- 基础配置文件：
~/.kerminal/config.toml - 环境变量：
~/.kerminal/.env - 会话存储：
~/.kerminal/sessions/ - 二进制组件：
~/.kerminal/bin/ - Skills：
~/.kerminal/skills/
如何修改 Kerminal 的环境目录？
MAC/Linux:
输入以下命令可修改环境目录
export KERMINAL_HOME=/custom/path- 基础配置文件：
/custom/path/config.toml - 环境变量：
/custom/path/.env - 会话存储：
/custom/path/sessions/ - 二进制组件：
/custom/path/bin/
Windows（请使用 PowerShell）:
输入以下命令可以修改环境目录
$env:KERMINAL_HOME = "C:\custom\path"- 基础配置文件：
C:\custom\path\config.toml - 环境变量：
C:\custom\path\.env - 会话存储：
C:\custom\path\sessions\ - 二进制组件：
C:\custom\path\bin\
Kerminal 通过 AGENTS.md 存储重要记忆
在项目根目录创建 AGENTS.md，可以为 AI 提供项目特定的指导：
# 项目指南
## 代码风格
- 使用 4 空格缩进
- 函数名使用 snake_case
## 项目结构
- src/ 包含主要源码
- tests/ 包含测试文件Kerminal 如何存储记忆？
Kerminal 的记忆存储在 ~/.kerminal 目录下，支持跨会话持久化。
Kerminal 支持创建 / 自定义 Skills
步骤 1：创建可复用的任务模板
mkdir -p ~/.kerminal/skills/code-review步骤 2：编辑 ~/.kerminal/skills/code-review/SKILL.md
---
name: code-review
description: 代码审查助手
---
# 代码审查
请对提供的代码进行审查，关注：
- 代码质量
- 潜在 bug
- 性能问题
- 安全隐患步骤 3：调用已安装的 Skills
-
方式一：通过
/skill-name快速调用在输入框中输入
/后，可模糊检索所有已安装的 Skills。选中目标 Skill 后，按Enter即可调用，并可额外输入 prompt ，再次按Enter一并发送。 -
方式二：通过
/view-skills查看 Skill 列表 输入/view-skills可查看当前已安装的 Skills 列表。列表支持模糊检索，选中某个 Skill 后，按Enter可查看该 Skill 的完整内容。
Kerminal 支持全局 Skills 加载
Kerminal 支持从 ~/.agents/skills 或 ~/.kerminal/skills 加载全局 skills。你可以将常用 skill 安装到该目录下，后续在不同项目中都可以直接调用。
兼容主流 skill 管理方式，可配合 npx 在 ~/.agents/skills 目录安装或卸载 skill，方便统一管理本地 skills。
Kerminal 支持 MCP 接入外部工具
Kerminal 支持 Model Context Protocol，可以连接外部工具：
1 # ~/.kerminal/config.toml
2 [mcp]
3 enabled = true
4
5 [[mcp.servers]]
6 name = "my-tool"
7 command = "/path/to/mcp-server"