HabitMCP TUI

一个基于终端的习惯追踪应用，使用Bubble Tea构建。

此TUI与habitmcp.com的后端/API协同工作。有趣的是，HabitMCP有一个MCP服务器，因此你可以使用你的习惯数据与Claude或你最喜欢的代理框架来构建自己的AI健康教练。HabitMCP允许导入和导出你的数据，并且服务完全免费。

功能

• 🎨 美观的TUI - 使用Bubble Tea的交互式终端界面
• 🔐 安全认证 - 使用系统密钥环进行安全令牌存储的登录/注册
• ✅ 习惯管理 - 创建、完成和跟踪习惯
• 📊 实时统计 - 查看连续天数、完成率和进度
• 🔄 API集成 - 同步到HabitMCP后端
• ⌨️ 键盘导航 - 完整的键盘支持以提高工作效率

安装

使用go install

go install github.com/jpzk/habitmcp-tui@latest

从源码安装

git clone https://github.com/jpzk/habitmcp-tui.git
cd habitmcp-tui
go build -o habitmcp .
sudo cp habitmcp /usr/local/bin/

要求

• Go 1.23 或更高版本
• 访问HabitMCP API（默认：https://habitmcp.com/api）

使用

启动TUI

只需运行：

habitmcp

这将启动交互式的终端界面。

首次设置

1. 当你首次启动应用程序时，你会看到登录屏幕
2. 按 Ctrl+R 在登录和注册之间切换
3. 输入你的凭据并按 Enter
4. 你的认证令牌将被安全地存储在你的系统密钥环中

导航

登录屏幕

• Tab / Shift+Tab - 在用户名和密码字段之间切换
• Ctrl+R - 在登录和注册之间切换
• Enter - 提交凭据
• Ctrl+C - 退出

习惯列表

• ↑ / ↓ - 在习惯之间导航
• Space / Enter - 切换今天是否完成该习惯
• a - 添加新习惯
• r - 从服务器刷新习惯
• q - 退出应用程序

添加习惯屏幕

• Tab / Shift+Tab - 在字段之间导航
• Enter - 移动到下一个字段 / 创建习惯
• Esc - 取消并返回到习惯列表

配置

CLI 存储配置在：

• Linux/macOS: ~/.config/habitmcp/config.json
• Windows: %APPDATA%\habitmcp\config.json

配置选项：

{
  "api_url": "https://habitmcp.com/api",
  "theme": "dark",
  "auto_sync": true,
  "sync_interval": 300,
  "offline_mode": false,
  "notifications": true,
  "current_username": "your_username"
}

认证

认证令牌被安全地存储在你的系统密钥环中：

• Linux: Secret Service API (GNOME Keyring, KWallet)
• macOS: Keychain
• Windows: Credential Manager

开发

项目结构

habitmcp-tui/
├── main.go                    # 入口点
├── internal/
│   ├── api/
│   │   └── client.go         # API客户端
│   ├── auth/
│   │   └── auth.go           # 认证管理器
│   ├── config/
│   │   └── config.go         # 配置管理
│   ├── models/
│   │   └── habit.go          # 数据模型
│   └── ui/
│       └── ui.go             # Bubble Tea UI
├── go.mod
└── README.md

构建

go build -o habitmcp .

运行测试

go test ./...

依赖项

• Bubble Tea - TUI框架
• Bubbles - TUI组件
• Lip Gloss - 样式
• go-keyring - 安全凭证存储
• Cobra - CLI框架

故障排除

"错误：认证失败"

• 确保你在HabitMCP平台上已注册
• 检查配置中的API URL是否正确
• 尝试注销并重新登录

"错误：网络错误"

• 验证互联网连接
• 检查API服务器是否可访问
• 确保防火墙/代理设置允许连接

密钥环访问问题

• Linux: 安装 gnome-keyring 或 kwallet
• macOS: Keychain 应该默认工作
• Windows: 不需要额外设置

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT