Wake records terminal sessions, including commands, outputs, and git context, for Claude Code to analyze. Benefits developers by providing context for AI-assisted debugging and code review. Integrates with terminal workflows and connects to Claude Code for enhanced productivity.
git clone https://github.com/joemckenney/wake.gitWake captures your terminal sessions including commands, outputs, and git context, storing them in a local SQLite database accessible to Claude Code via MCP. Instead of manually copying terminal output or describing what happened, Claude sees your actual command history and can analyze errors, logs, and build output directly. The tool automatically summarizes command outputs using a local LLM, enabling Claude to quickly understand what occurred without reading full output. Wake integrates seamlessly into your shell workflow—just run `wake shell` to start recording, work normally, then ask Claude to analyze what happened. Features include session search, command history with metadata, tiered output retrieval to optimize context usage, and configurable retention policies.
[{"step":"Install the wake skill in your terminal environment. For most setups, this involves running: `pip install wake-skill` or adding it to your Claude Code extensions directory.","tip":"Ensure your terminal session has access to the project directory and git repository. The skill works best when run from the project root."},{"step":"Execute the wake command with your project path. Example: `wake /path/to/your/project` or simply `wake` if already in the project directory.","tip":"For focused analysis, add flags like `--focus tests/` or `--focus src/auth/`. This narrows the context to specific areas."},{"step":"Copy the generated context summary and paste it into Claude Code or your preferred AI assistant.","tip":"Use the `## Terminal Session Context` header as a delimiter when pasting into long conversations to help the AI understand the boundaries."},{"step":"Ask specific follow-up questions in Claude Code based on the context. Examples: 'Why is the JWT validation failing in the integration tests?' or 'Suggest improvements to the test coverage for the auth module.'","tip":"Reference line numbers or file paths from the context to make your questions more precise. The AI can then analyze the exact code causing issues."},{"step":"Iterate by running additional wake commands after making changes. Example: `wake && ask 'How do these changes affect the test suite?'`","tip":"Combine with terminal tools like `git diff` or `npm run lint` to get even richer context before waking the session."}]
Debugging failed builds or deployments by giving Claude full log context
Analyzing Kubernetes pod errors and cluster issues from kubectl output
Code review with full git diff and test output history
Troubleshooting CI/CD failures with complete job logs
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/joemckenney/wakeCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Wake the terminal session for [PROJECT_PATH] and summarize the context including: recent commands run, outputs from those commands, and git status/context. Focus on [SPECIFIC_AREA] if provided. Format the summary for direct use in Claude Code analysis.
### Terminal Session Context - Project: `acme-crm` (v2.1.0)
**Recent Commands:**
```bash
$ git checkout feature/user-authentication
Switched to branch 'feature/user-authentication'
$ npm install
added 12 packages, removed 3 packages, and updated 17 packages
$ npm run test:integration
PASS tests/auth.test.js (12.4s)
● Authentication Service › login() › should validate credentials
✓ returns token for valid credentials (450ms)
```
**Git Context:**
- Branch: `feature/user-authentication` (ahead 2 commits)
- Changes: 15 files modified (auth/, models/, tests/)
- Last commit: "feat: add JWT validation middleware" (0a1b2c3)
- Unpushed changes: 2 commits to origin
**Terminal Outputs:**
- `npm install` completed successfully with dependency updates
- Integration tests passed (12.4s total, 12 tests)
- No errors in recent command outputs
**Current State:**
- Working directory: clean (no uncommitted changes)
- Node.js: v18.17.0
- Relevant files: `src/middleware/auth.js`, `tests/auth.test.js`
This context is ready for Claude Code to analyze potential issues in the JWT validation middleware or suggest improvements to the test suite.AI assistant built for thoughtful, nuanced conversation
Get more done every day with Microsoft Teams – powered by AI
Automate security compliance and monitor real-time security posture seamlessly.
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan