文档/操作指南/基础使用
基础使用
快速上手 Kerminal 的日常操作
如何唤醒 Kerminal？
在终端中输入以下命令即可唤醒：
#启动交互式模式
kerminalExec 模式：直接在终端获取结果
# 示例：在受信任的 Git 仓库中直接执行
kerminal exec "帮我输出今日总结"
# 示例：在非 Git 目录（如家目录）中强制执行
kerminal exec "帮我输出今日总结" --skip-git-repo-check恢复历史对话
Kerminal 可以恢复历史对话：
使用以下命令可以恢复您上次的对话
# 显示会话选择器
kerminal resume
# 恢复最近的会话
kerminal resume --last
# 查看全部历史对话
kerminal resume --all在 resume 页面下：
- 可查看会话所在的
git branch - 可根据首句提示词检索会话
- 可在创建会话时间优先或更新时间优先间切换会话排列
Ctrl + D两次可以删除选中的历史会话resume后可以看到完整的历史记录，包括工具调用等历史
如何升级版本
使用以下命令可以升级至最新版本
# 自动检查当前版本并升级至最新版本
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
- 性能问题
- 安全隐患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"