https://github.com/crystalphantom/pgit-cli
Private Git: A powerful Git workflow enhancer with AI agent file management, presets, and smart commands. Simplify your development process with private storage and version control for multiple AI tools.
https://github.com/crystalphantom/pgit-cli
ai-agents cli developer-tool git productivity
Last synced: about 1 month ago
JSON representation
Private Git: A powerful Git workflow enhancer with AI agent file management, presets, and smart commands. Simplify your development process with private storage and version control for multiple AI tools.
- Host: GitHub
- URL: https://github.com/crystalphantom/pgit-cli
- Owner: crystalphantom
- License: mit
- Created: 2025-09-14T09:31:55.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-05-01T10:42:44.000Z (about 2 months ago)
- Last Synced: 2026-05-01T12:24:47.511Z (about 2 months ago)
- Topics: ai-agents, cli, developer-tool, git, productivity
- Language: TypeScript
- Homepage:
- Size: 632 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
- Security: docs/SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# PGit CLI
[](https://www.npmjs.com/package/pgit-cli)
[](https://nodejs.org/)
[](https://www.typescriptlang.org/)
[](https://opensource.org/licenses/MIT)
**Private Git Tracking CLI** — Manage local, private, and agent-specific files without committing them to your shared Git history.
PGit keeps local configurations, agent-specific folders (like `.docs/` ,`.specs/` , `.plans/`, `.claude/`, `.superpowers/`, `.opencode/`), and private notes visible to your local environment and agents, while securely storing them in a user-level private store that stays out of your main codebase's history.
## Quick Start
### Installation
```bash
npm install -g pgit-cli
```
### Basic Usage
Track files locally in your private store:
```bash
cd your-project
# Add files and folders to your private store
pgit add .claude/ .superpowers/ .opencode/ specs/
```
Synchronize your private configs across machines/workspaces:
```bash
# Push your local updates to your private store
pgit push .
# Pull private configurations into a new workspace
pgit pull .
# Or sync only specific tracked paths
pgit push todo.md docs
pgit pull todo.md
# Check the sync status (drift)
pgit status
```
**Develop with Agents:**
Use the AI coding agents of your choice (e.g., Claude Code, OpenCode) to implement features leveraging your private, local context.
**Clean up before Code Review:**
Once feature development is done, you can drop the private files from your working tree before doing a code review or creating a PR.
```bash
pgit drop .
```
*Note: Don't worry if you accidentally try to commit directly—PGit automatically installs `pre-commit` and `pre-push` hooks to prevent your tracked private files from leaking into the shared repository.*
## Documentation
Comprehensive guides, architecture details, and full command references can be found in our documentation:
- 📖 [Full Command Reference](./docs/commands.md)
- 🏗️ [Architecture Overview](./docs/architecture.md)
- 🔄 [Legacy Workflows](./docs/legacy.md)
- 🛠️ [Troubleshooting Guide](./docs/troubleshooting.md)
## Contributing & Security
- **Contributing**: Please see our [Contributing Guide](./docs/CONTRIBUTING.md) to get started with development, testing, and submitting pull requests.
- **Security**: All files stay strictly local. See [Security & Privacy](./docs/SECURITY.md) for more details.
## System Requirements
- **Node.js**: 18.0.0 or higher
- **Git**: Must be installed and available in `PATH`
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
**Made with ❤️ by developers, for developers who value privacy and clean git workflows.**