roo-logger

日本語版はこちら

• What is it? — This is an MCP server that automatically logs Roo Code(Cline)'s activities, such as command executions and code generation.
• What does it do? — It saves activity history as JSON files, which you can search and analyze later.
• How do I use it? — Add it to your Cline or Roo-Code settings to enable automatic activity logging.

Roo Activity Logger is an MCP (Model Context Protocol) server that automatically records Roo's development activities — including command executions, code generation, file operations, and more. All logs are saved in JSON format, making it easy to search, analyze, and restore context at any time.

flowchart TD
    A[Roo's Action] --> B[Select Activity Type]
    B --> C[Log via log_activity]
    C --> D[Provide Log Info<br>- Summary<br>- Details<br>- Intention<br>- Context]
    D --> E[Specify Save Directory]
    E --> F[Save as JSON file]

flowchart TD
    G[Resume Task] --> H[Search with search_logs]
    H --> I[Set Search Filters<br>- Type<br>- Date Range<br>- Text]
    I --> J[Retrieve Related Activities<br>- Parent/Child<br>- Sequence<br>- Related IDs]
    J --> K[Restore Context & Resume<br>- Review Past Intentions<br>- Understand Progress]

Here is an example of a file_operation log entry saved as JSON:

{
  "id": "75add15d-8d5b-4e60-b327-fde785050c86",
  "timestamp": "2025-04-10T01:58:02.905Z",
  "type": "file_operation",
  "level": "info",
  "summary": "Inserted mermaid diagram into README.md",
  "details": {
    "file": "README.md",
    "operation": "insert_content",
    "insertedLines": "mermaid code block",
    "position": "after overview section"
  },
  "intention": "To visually explain the flow of saving and retrieving activities",
  "context": "Improving documentation for Roo Activity Logger",
  "parentId": "98280366-1de1-48e0-9914-b3a3409599b4"
}

Each log contains:

• Log level (debug, info, warn, error)
• Summary
• Details (any structured data)
• Intention / Purpose
• Context information
• Parent activity ID (for hierarchy)
• Sequence number (for ordering)
• Related activity IDs (for grouping)

Logs are:

• Saved as date-based JSON files
• Searchable by type, level, date, text, etc.
• Customizable — you can specify different save directories per activity

• Logs various activity types:

  • Command executions (command_execution)
  • Code generation (code_generation)
  • File operations (file_operation)
  • Errors (error_encountered)
  • Decisions (decision_made)
  • Conversations (conversation)

• Each activity log includes:

  • Unique ID
  • Timestamp
  • Activity type
  • Summary, details, intention, context, and optional metadata

You can run Roo Activity Logger directly without cloning the repository by using npx.

Add this to your Cline or Roo-Code configuration:

{
  "mcpServers": {
    "roo-activity-logger": {
      "command": "npx",
      "args": ["-y", "github:annenpolka/roo-logger"],
      "env": {},
      "disabled": false
    }
  }
}

Then, add prompts to your rule files to ensure logging, for example:

## Important

Always log activities using roo-activity-logger according to the logging rules.

## Preparation

Check the current context with `git status`.

Then, use roo-activity-logger's `search_logs` to review existing logs and identify current tasks.

Be sure to perform the logging steps.

## Logging

- Always use roo-activity-logger for all logs
- Include stack traces and execution context
- Record intention and context

To develop or customize locally, clone the repository and build:

# Clone the repo (replace yourusername with your actual username/org)
git clone https://github.com/annenpolka/roo-logger.git
cd roo-logger

# Install dependencies
npm install

# Build
npm run build

Example configuration to use your local build:

{
  "mcpServers": {
    "roo-activity-logger": {
      "command": "node",
      "args": ["/path/to/your/local/roo-logger/dist/index.js"], // adjust path accordingly
      "env": {},
      "disabled": false
    }
  }
}

• The specified directory will be created automatically if it does not exist.

A tool to record an activity.

{
  "type": "command_execution",
  "summary": "Run npm command",
  "intention": "Update project dependencies",
  "context": "Preparing for new feature development",
  "logsDir": "/absolute/path/to/logs/activity"
}

{
  "type": "file_operation",
  "summary": "Update README file",
  "intention": "Clarify documentation and improve usability",
  "context": "Improvements based on user feedback",
  "level": "info",
  "details": {
    "file": "README.md",
    "operation": "update",
    "changedLines": 15
  },
  "logsDir": "/absolute/path/to/logs/activity",
  "sequence": 3,
  "relatedIds": ["11223344-5566-7788-99aa-bbccddeeff00"]
}

Lists saved log files recursively. You can specify the maximum search depth.

{
  "logsDir": "/absolute/path/to/logs"
}

Searches saved logs with various filters.

{
  "logsDir": "/absolute/path/to/logs"
}

{
  "logsDir": "/absolute/path/to/logs",
  "type": "command_execution"
}

MIT