# CommandLogger

**Repository Path**: tismagic/command-logger

## Basic Information

- **Project Name**: CommandLogger
- **Description**: Command Logger - 命令记录工具 CREATED BY TISMAGIC AND CURSOR
一个简单但功能强大的命令行历史记录工具，帮助你追踪和管理在终端中执行的命令。支持 bash 和 zsh shell。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-02
- **Last Updated**: 2024-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Command Logger - 命令记录工具

一个简单但功能强大的命令行历史记录工具，帮助你追踪和管理在终端中执行的命令。支持 bash 和 zsh shell。

## 系统要求

- Linux 或 macOS 系统
- bash 或 zsh shell
- 基本的命令行工具（sed, grep 等）

## 功能特点

- 🔄 自动记录所有执行的命令
- 🏷️ 支持添加重要标记
- 🗑️ 灵活的删除功能
- 📖 便捷的历史查看
- 🎨 彩色输出提示

## 快速开始

### 安装

1. 下载安装脚本：
   ```bash
   # Linux 用户：
   wget https://gitee.com/tismagic/command-logger/raw/main/install.sh
   
   # macOS 用户：
   curl -O https://gitee.com/tismagic/command-logger/raw/main/install.sh
   
   # 或者直接复制install.sh文件到本地
   ```

2. 运行安装脚本：
   ```bash
   bash install.sh
   ```

3. 使配置生效：
   ```bash
   # 如果使用 bash：
   source ~/.bashrc
   
   # 如果使用 zsh：
   source ~/.zshrc
   
   # 或者直接重新打开终端
   ```

### 基本使用

1. **查看命令历史**
   - 查看最近100行记录：
     ```bash
     hislog
     ```
   - 查看指定行数记录：
     ```bash
     hislog 200  # 查看最近200行
     ```

2. **添加重要标记**
   ```bash
   tag 这是一个重要的标记
   ```
   标记将以醒目的紫色显示在日志中

3. **删除记录**
   ```bash
   del 1    # 删除最后一条记录
   del 5    # 删除最后5条记录
   ```

## 文件位置

- 主程序：`~/.local/bin/command_logger.sh`
- 日志文件：`~/.command_history.log`
- 配置文件：添加到 `~/.bashrc` 或 `~/.zshrc`

## 注意事项

- 所有命令都会自动记录到日志文件中
- `del` 命令删除操作不可撤销
- `tag` 命令用于添加重要标记，方便后续查找
- `hislog` 默认显示最近100行，可以自定义显示行数

## 卸载

使用卸载脚本卸载：
```bash
bash uninstall.sh
```

卸载脚本会自动：
- 备份您的命令历史记录
- 清理所有相关文件
- 移除配置项

卸载后重新加载配置：
```bash
# 如果使用 bash：
source ~/.bashrc

# 如果使用 zsh：
source ~/.zshrc

# 或者直接重新打开终端
```

## 许可证

MIT License