# mem8
Context management toolkit for AI-assisted development. Manage memory, templates, and workflows with Claude Code and other AI tools.
## Quick Start
```bash
# Install
uv tool install mem8
# Initialize workspace
cd your-project
mem8 init
# Check status
mem8 status
```
## Core Features
### 🧠 Context Window Management
Persistent memory system for Claude Code with structured documentation. Keep AI context focused and relevant across long development sessions.
```bash
# Search your memory
mem8 search "authentication"
# Use Claude Code commands
/mem8:research "payment system"
/mem8:plan "add OAuth support"
/mem8:implement memory/shared/plans/oauth.md
/mem8:commit
```
### 🔧 Toolbelt Integration
Verify and manage CLI tools required for AI workflows.
```bash
# Check for missing tools
mem8 doctor
# Auto-install missing tools
mem8 doctor --fix
# List all tools and versions
mem8 tools
```
Verified tools include: `ripgrep`, `fd`, `jq`, `gh`, `git`, `bat`, `delta`, `ast-grep`, and more.
### 🚢 Port Management
Global port leasing system prevents conflicts across projects.
```bash
# Lease port range for project
mem8 ports --lease
# View assigned ports
mem8 ports
# Kill process on port (safe mode)
mem8 ports --kill 20000
```
### 🎨 External Templates
Share standardized configurations across teams using GitHub templates.
```bash
# Use official templates
mem8 init --template-source killerapp/mem8-plugin
# Use team templates
mem8 init --template-source your-org/templates
# Set default for all projects
mem8 templates set-default your-org/templates
```
### 🤖 Claude Code Integration
Custom commands and agents for enhanced AI workflows.
Commands installed by default:
- `/mem8:research` - Parallel codebase exploration
- `/mem8:plan` - Structured implementation planning
- `/mem8:implement` - Execute plans with progress tracking
- `/mem8:validate` - Verify implementation completeness
- `/mem8:commit` - Create semantic commits
- `/mem8:describe-pr` - Generate PR descriptions
## Documentation
**📚 Full documentation at [codebasecontext.org](https://codebasecontext.org)**
- [Getting Started](https://codebasecontext.org/docs/user-guide/getting-started)
- [CLI Commands](https://codebasecontext.org/docs/user-guide/cli-commands)
- [External Templates](https://codebasecontext.org/docs/external-templates)
- [Contributing](https://codebasecontext.org/docs/contributing)
## Development Workflow
mem8 provides a structured development cycle:
1. **Research** (`/mem8:research`) - Understand existing patterns
2. **Plan** (`/mem8:plan`) - Design with concrete steps
3. **Implement** (`/mem8:implement`) - Execute with progress tracking
4. **Validate** (`/mem8:validate`) - Verify completeness
5. **Commit** (`/mem8:commit`) - Create semantic commits
## Project Structure
After running `mem8 init --template full`:
```
your-project/
├── .claude/
│ ├── commands/ # Custom slash commands
│ └── agents/ # Custom agent definitions
├── memory/
│ └── shared/
│ ├── research/ # Research documents
│ ├── plans/ # Implementation plans
│ ├── prs/ # PR descriptions
│ └── decisions/ # Technical decisions
└── .mem8/
├── config.yaml # Configuration
├── ports.md # Port assignments
└── tools.md # Tool inventory
```
## Requirements
- Python 3.11+
- uv (recommended) or pip
Optional:
- Docker (for backend API features)
- Node.js 18+ (for web interface)
## Support
- 📖 [Documentation](https://codebasecontext.org)
- 🐛 [Report Issues](https://github.com/killerapp/mem8/issues)
- 💬 [Discussions](https://github.com/killerapp/mem8/discussions)
- 🔧 [Template Repository](https://github.com/killerapp/mem8-plugin)
## License
MIT License - see LICENSE file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "mem8",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai-development, claude-code, context-management, memory, port-management, templates, toolbelt",
"author": null,
"author_email": "killerapp <vaskin@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c3/1a/ecf06d4b6fb4b637c67ea3a82ea121ab394673c22829fbf73189fa25718c/mem8-6.0.0.tar.gz",
"platform": null,
"description": "# mem8\n\nContext management toolkit for AI-assisted development. Manage memory, templates, and workflows with Claude Code and other AI tools.\n\n## Quick Start\n\n```bash\n# Install\nuv tool install mem8\n\n# Initialize workspace\ncd your-project\nmem8 init\n\n# Check status\nmem8 status\n```\n\n## Core Features\n\n### \ud83e\udde0 Context Window Management\nPersistent memory system for Claude Code with structured documentation. Keep AI context focused and relevant across long development sessions.\n\n```bash\n# Search your memory\nmem8 search \"authentication\"\n\n# Use Claude Code commands\n/mem8:research \"payment system\"\n/mem8:plan \"add OAuth support\"\n/mem8:implement memory/shared/plans/oauth.md\n/mem8:commit\n```\n\n### \ud83d\udd27 Toolbelt Integration\nVerify and manage CLI tools required for AI workflows.\n\n```bash\n# Check for missing tools\nmem8 doctor\n\n# Auto-install missing tools\nmem8 doctor --fix\n\n# List all tools and versions\nmem8 tools\n```\n\nVerified tools include: `ripgrep`, `fd`, `jq`, `gh`, `git`, `bat`, `delta`, `ast-grep`, and more.\n\n### \ud83d\udea2 Port Management\nGlobal port leasing system prevents conflicts across projects.\n\n```bash\n# Lease port range for project\nmem8 ports --lease\n\n# View assigned ports\nmem8 ports\n\n# Kill process on port (safe mode)\nmem8 ports --kill 20000\n```\n\n### \ud83c\udfa8 External Templates\nShare standardized configurations across teams using GitHub templates.\n\n```bash\n# Use official templates\nmem8 init --template-source killerapp/mem8-plugin\n\n# Use team templates\nmem8 init --template-source your-org/templates\n\n# Set default for all projects\nmem8 templates set-default your-org/templates\n```\n\n### \ud83e\udd16 Claude Code Integration\nCustom commands and agents for enhanced AI workflows.\n\nCommands installed by default:\n- `/mem8:research` - Parallel codebase exploration\n- `/mem8:plan` - Structured implementation planning\n- `/mem8:implement` - Execute plans with progress tracking\n- `/mem8:validate` - Verify implementation completeness\n- `/mem8:commit` - Create semantic commits\n- `/mem8:describe-pr` - Generate PR descriptions\n\n## Documentation\n\n**\ud83d\udcda Full documentation at [codebasecontext.org](https://codebasecontext.org)**\n\n- [Getting Started](https://codebasecontext.org/docs/user-guide/getting-started)\n- [CLI Commands](https://codebasecontext.org/docs/user-guide/cli-commands)\n- [External Templates](https://codebasecontext.org/docs/external-templates)\n- [Contributing](https://codebasecontext.org/docs/contributing)\n\n## Development Workflow\n\nmem8 provides a structured development cycle:\n\n1. **Research** (`/mem8:research`) - Understand existing patterns\n2. **Plan** (`/mem8:plan`) - Design with concrete steps\n3. **Implement** (`/mem8:implement`) - Execute with progress tracking\n4. **Validate** (`/mem8:validate`) - Verify completeness\n5. **Commit** (`/mem8:commit`) - Create semantic commits\n\n## Project Structure\n\nAfter running `mem8 init --template full`:\n\n```\nyour-project/\n\u251c\u2500\u2500 .claude/\n\u2502 \u251c\u2500\u2500 commands/ # Custom slash commands\n\u2502 \u2514\u2500\u2500 agents/ # Custom agent definitions\n\u251c\u2500\u2500 memory/\n\u2502 \u2514\u2500\u2500 shared/\n\u2502 \u251c\u2500\u2500 research/ # Research documents\n\u2502 \u251c\u2500\u2500 plans/ # Implementation plans\n\u2502 \u251c\u2500\u2500 prs/ # PR descriptions\n\u2502 \u2514\u2500\u2500 decisions/ # Technical decisions\n\u2514\u2500\u2500 .mem8/\n \u251c\u2500\u2500 config.yaml # Configuration\n \u251c\u2500\u2500 ports.md # Port assignments\n \u2514\u2500\u2500 tools.md # Tool inventory\n```\n\n## Requirements\n\n- Python 3.11+\n- uv (recommended) or pip\n\nOptional:\n- Docker (for backend API features)\n- Node.js 18+ (for web interface)\n\n## Support\n\n- \ud83d\udcd6 [Documentation](https://codebasecontext.org)\n- \ud83d\udc1b [Report Issues](https://github.com/killerapp/mem8/issues)\n- \ud83d\udcac [Discussions](https://github.com/killerapp/mem8/discussions)\n- \ud83d\udd27 [Template Repository](https://github.com/killerapp/mem8-plugin)\n\n## License\n\nMIT License - see LICENSE file for details.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Context management toolkit for AI-assisted development",
"version": "6.0.0",
"project_urls": {
"Documentation": "https://github.com/killerapp/mem8#readme",
"Homepage": "https://github.com/killerapp/mem8",
"Issues": "https://github.com/killerapp/mem8/issues",
"Repository": "https://github.com/killerapp/mem8"
},
"split_keywords": [
"ai-development",
" claude-code",
" context-management",
" memory",
" port-management",
" templates",
" toolbelt"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "22b0f3b04f9e8147a697d4a5a8982c6301914ec34c6db2f5327532f2072eef32",
"md5": "3c6047cbe6b2545baf0aca93d33c12dd",
"sha256": "155be401edc52dbda6058ac3ab9385aae949b19ee3dc14a04146b2efb9929084"
},
"downloads": -1,
"filename": "mem8-6.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3c6047cbe6b2545baf0aca93d33c12dd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 108783,
"upload_time": "2025-10-15T20:30:33",
"upload_time_iso_8601": "2025-10-15T20:30:33.511004Z",
"url": "https://files.pythonhosted.org/packages/22/b0/f3b04f9e8147a697d4a5a8982c6301914ec34c6db2f5327532f2072eef32/mem8-6.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c31aecf06d4b6fb4b637c67ea3a82ea121ab394673c22829fbf73189fa25718c",
"md5": "b8bbb76296ac5489f5aa3024beca72f9",
"sha256": "daf23cb110b16aea5434b18b3ed1da76e422a1a3db657733e01cd504aa5380b8"
},
"downloads": -1,
"filename": "mem8-6.0.0.tar.gz",
"has_sig": false,
"md5_digest": "b8bbb76296ac5489f5aa3024beca72f9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 1528374,
"upload_time": "2025-10-15T20:30:34",
"upload_time_iso_8601": "2025-10-15T20:30:34.554578Z",
"url": "https://files.pythonhosted.org/packages/c3/1a/ecf06d4b6fb4b637c67ea3a82ea121ab394673c22829fbf73189fa25718c/mem8-6.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-15 20:30:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "killerapp",
"github_project": "mem8#readme",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "mem8"
}
JSON
