/journal-add

Add Journal Entry

You are helping the user add a journal entry.

Process

1. **Gather information:**

• **Title** (required): Ask for a brief title
• **Description** (required): Ask for 1-2 sentence description
• **Project** (optional): Ask if this is related to a specific project/repo
• If user is in a git repo, suggest using the repo name
• If not specified, can be left empty
• **Tags** (optional): Suggest relevant tags based on the content
• Technical terms mentioned
• Type of work (feature, bugfix, refactor, etc.)
• Technologies used

2. **Use the MCP tool:** Call `journal_add` with the gathered information:

   journal_add(
     title="User's title",
     description="User's description",
     project="project-name" (if provided),
     tags=["tag1", "tag2"] (if provided)
   )

3. **Confirm success:** Tell the user their entry was saved and show the ID for reference.

Examples

**Example 1: Simple entry**

• Title: "Implemented OAuth login"
• Description: "Built OAuth2 flow with JWT tokens for user authentication"
• Project: "my-app"
• Tags: ["auth", "oauth", "backend"]

**Example 2: Bug fix**

• Title: "Fixed memory leak in cache"
• Description: "Cache wasn't clearing old entries, causing gradual memory growth"
• Tags: ["bugfix", "performance", "cache"]

Tips

• Suggest concise titles (3-7 words)
• Descriptions should be complete sentences
• Tags help with searching later
• Project name helps organize multi-repo work