# kcpwd
**Keychain Password Manager CLI** - A simple, secure command-line password manager for macOS that uses the native macOS Keychain.
## Features
- 🔐 Secure storage using macOS Keychain
- 📋 Automatic clipboard copying
- 🚀 Simple CLI interface
- 🔒 No passwords stored in plain text
- 🍎 Native macOS integration
## Installation
### From PyPI
```bash
pip install kcpwd
```
### From Source
```bash
git clone https://github.com/osmanuygar/kcpwd.git
cd kcpwd
pip install -e .
```
## Usage
### Store a password
```bash
kcpwd set dbadmin asd123
```
### Retrieve a password (copies to clipboard)
```bash
kcpwd get dbadmin
```
### Delete a password
```bash
kcpwd delete dbadmin
```
### List stored keys
```bash
kcpwd list
```
## How It Works
`kcpwd` stores your passwords in the **macOS Keychain** - the same secure, encrypted storage that Safari and other macOS apps use. This means:
- Passwords are encrypted with your Mac's security
- They persist across reboots
- They're protected by your Mac's login password
- No plain text files or databases
### Viewing Your Passwords
Open **Keychain Access** app and search for "kcpwd" to see all stored passwords.
Or use Terminal:
```bash
security find-generic-password -s "kcpwd" -a "dbadmin" -w
```
## Security Notes
⚠️ **Important Security Considerations:**
- Passwords are stored in macOS Keychain (encrypted)
- Passwords remain in clipboard until you copy something else
- Consider clearing clipboard after use for sensitive passwords
- Designed for personal use on trusted devices
- Always use strong, unique passwords
## Requirements
- **macOS only** (uses native Keychain)
- Python 3.8+
## Development
### Setup development environment
```bash
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .
```
### Run tests
```bash
pytest
```
## Project Structure
```
kcpwd/
├── kcpwd/
│ ├── __init__.py
│ └── cli.py
├── tests/
│ └── test_cli.py
├── setup.py
├── README.md
├── LICENSE
└── requirements.txt
```
## License
MIT License - See LICENSE file for details
## Contributing
Contributions welcome! Please feel free to submit a Pull Request.
## Disclaimer
This is a personal password manager tool. While it uses secure storage (macOS Keychain), please use at your own risk. For enterprise or critical password management, consider established solutions like 1Password, Bitwarden, or similar.
## Roadmap
- [ ] Master password protection
- [ ] Auto-clear clipboard after X seconds
- [ ] Password generation
- [ ] Import/export functionality
- [ ] Password strength indicator
- [ ] Cross-platform support (Linux, Windows)
Raw data
{
"_id": null,
"home_page": "https://github.com/osmanuygar/kcpwd",
"name": "kcpwd",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "password manager cli keychain macos security",
"author": "osmanuygar",
"author_email": "osmanuygar@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ab/a2/f8f0e71dab0709ca07390c0af153ee8b69e69ff883b09c186cb7f86c5d00/kcpwd-0.1.0.tar.gz",
"platform": null,
"description": "# kcpwd\n\n**Keychain Password Manager CLI** - A simple, secure command-line password manager for macOS that uses the native macOS Keychain.\n\n## Features\n\n- \ud83d\udd10 Secure storage using macOS Keychain\n- \ud83d\udccb Automatic clipboard copying\n- \ud83d\ude80 Simple CLI interface\n- \ud83d\udd12 No passwords stored in plain text\n- \ud83c\udf4e Native macOS integration\n\n## Installation\n\n### From PyPI\n```bash\npip install kcpwd\n```\n\n### From Source\n```bash\ngit clone https://github.com/osmanuygar/kcpwd.git\ncd kcpwd\npip install -e .\n```\n\n## Usage\n\n### Store a password\n```bash\nkcpwd set dbadmin asd123\n```\n\n### Retrieve a password (copies to clipboard)\n```bash\nkcpwd get dbadmin\n```\n\n### Delete a password\n```bash\nkcpwd delete dbadmin\n```\n\n### List stored keys\n```bash\nkcpwd list\n```\n\n## How It Works\n\n`kcpwd` stores your passwords in the **macOS Keychain** - the same secure, encrypted storage that Safari and other macOS apps use. This means:\n\n- Passwords are encrypted with your Mac's security\n- They persist across reboots\n- They're protected by your Mac's login password\n- No plain text files or databases\n\n### Viewing Your Passwords\n\nOpen **Keychain Access** app and search for \"kcpwd\" to see all stored passwords.\n\nOr use Terminal:\n```bash\nsecurity find-generic-password -s \"kcpwd\" -a \"dbadmin\" -w\n```\n\n## Security Notes\n\n\u26a0\ufe0f **Important Security Considerations:**\n\n- Passwords are stored in macOS Keychain (encrypted)\n- Passwords remain in clipboard until you copy something else\n- Consider clearing clipboard after use for sensitive passwords\n- Designed for personal use on trusted devices\n- Always use strong, unique passwords\n\n## Requirements\n\n- **macOS only** (uses native Keychain)\n- Python 3.8+\n\n## Development\n\n### Setup development environment\n```bash\npython -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\npip install -e .\n```\n\n### Run tests\n```bash\npytest\n```\n\n## Project Structure\n```\nkcpwd/\n\u251c\u2500\u2500 kcpwd/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2514\u2500\u2500 cli.py\n\u251c\u2500\u2500 tests/\n\u2502 \u2514\u2500\u2500 test_cli.py\n\u251c\u2500\u2500 setup.py\n\u251c\u2500\u2500 README.md\n\u251c\u2500\u2500 LICENSE\n\u2514\u2500\u2500 requirements.txt\n```\n\n## License\n\nMIT License - See LICENSE file for details\n\n## Contributing\n\nContributions welcome! Please feel free to submit a Pull Request.\n\n## Disclaimer\n\nThis is a personal password manager tool. While it uses secure storage (macOS Keychain), please use at your own risk. For enterprise or critical password management, consider established solutions like 1Password, Bitwarden, or similar.\n\n## Roadmap\n\n- [ ] Master password protection\n- [ ] Auto-clear clipboard after X seconds\n- [ ] Password generation\n- [ ] Import/export functionality\n- [ ] Password strength indicator\n- [ ] Cross-platform support (Linux, Windows)\n",
"bugtrack_url": null,
"license": null,
"summary": "macOS Keychain Password Manager CLI - Simple and secure password storage",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/osmanuygar/kcpwd"
},
"split_keywords": [
"password",
"manager",
"cli",
"keychain",
"macos",
"security"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e0683d935869f353076dc674449f8da7a10d21fa30279797fd680549a6c6fcf2",
"md5": "f5b0236c14411cf53468b43ab8a89460",
"sha256": "00a3e27900987e28a74e01176e9b34eba3cf8d3ff090ba95bcb45db0e9709305"
},
"downloads": -1,
"filename": "kcpwd-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f5b0236c14411cf53468b43ab8a89460",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 5793,
"upload_time": "2025-10-10T08:53:41",
"upload_time_iso_8601": "2025-10-10T08:53:41.905164Z",
"url": "https://files.pythonhosted.org/packages/e0/68/3d935869f353076dc674449f8da7a10d21fa30279797fd680549a6c6fcf2/kcpwd-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "aba2f8f0e71dab0709ca07390c0af153ee8b69e69ff883b09c186cb7f86c5d00",
"md5": "7674a317c72c5938a3e7881e515fc1e2",
"sha256": "ce9e15381200b6b7d6af28a05698bab060e43c8e882d22062deb40392b12cbb2"
},
"downloads": -1,
"filename": "kcpwd-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "7674a317c72c5938a3e7881e515fc1e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 5382,
"upload_time": "2025-10-10T08:53:43",
"upload_time_iso_8601": "2025-10-10T08:53:43.249294Z",
"url": "https://files.pythonhosted.org/packages/ab/a2/f8f0e71dab0709ca07390c0af153ee8b69e69ff883b09c186cb7f86c5d00/kcpwd-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-10 08:53:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "osmanuygar",
"github_project": "kcpwd",
"github_not_found": true,
"lcname": "kcpwd"
}
JSON
