# Copper Sun Brass
> 🧠 Development Intelligence for AI Agents
Copper Sun Brass is an AI advisory system that acts as a "General Staff" for AI agents (like Claude Code) working on software projects. It provides persistent memory, project analysis, and intelligence gathering.
## 🚀 Quick Start
### One-Command Installation (Recommended)
```bash
# Install and activate trial in one command
curl -fsSL https://brass.coppersun.dev/setup | bash
# Navigate to your project and initialize
cd your-project
brass init
```
### Standard Installation
```bash
# Install from PyPI (recommended: pipx for isolated environment)
pipx install coppersun-brass
# Generate and activate 15-day trial
brass generate-trial --activate
# Configure Claude API (required)
brass config set claude_api_key sk-your-api-key
# Initialize in your project
cd your-project
brass init
```
### Check Status
```bash
# Verify everything is working
brass status
# Get AI insights for your project
brass insights
# View legal documents
brass legal
```
## 🎯 Key Features
### Four Specialized Agents
1. **Watch Agent** 👁️ - Continuous project monitoring
2. **Scout Agent** 🔍 - Deep code analysis and pattern detection
3. **Strategist Agent** 🎯 - High-level planning and recommendations
4. **Planner Agent** 📋 - Task generation and prioritization
### Core Capabilities
- **Persistent Memory** 💾 - Maintains context across AI sessions
- **Strategic Planning** 📊 - Project analysis and recommendations
- **Pattern Detection** 🔍 - Identifies code patterns and potential issues
- **File System Monitoring** 📡 - Tracks file changes in real-time
- **Code Intelligence** 🧠 - Security detection and architecture insights
- **External Integration Framework** 🔗 - Ready for Slack, GitHub, webhooks (coming soon)
- **Privacy-First** 🔒 - All data stays local on your machine
## 💡 How It Works
Copper Sun Brass creates a `.brass/` directory in your project containing:
- **Project context** that persists across AI sessions
- **Continuous analysis** by four specialized AI agents
- **Strategic insights** and recommendations
- **Development patterns** and best practices
When you work with Claude Code (or other AI assistants), they can access this context to provide much better, more informed assistance.
## 📖 Documentation
Complete documentation available at: **https://brass.coppersun.dev**
### Essential Commands
```bash
brass status # Check system status
brass init # Initialize project
brass insights # Get AI recommendations
brass refresh # Update project analysis
brass scout scan # Scan for code issues
brass legal # View legal documents
brass --help # See all commands
```
## 🔧 Requirements
- **Python**: 3.8 or later
- **Node.js**: 16+ with npm (auto-installs TypeScript analysis dependencies)
- **Operating System**: macOS, Linux, Windows (WSL)
- **Claude API Key**: Required for AI functionality
## 🛡️ License & Pricing
- **Free Trial**: 15 days, full features
- **Pro**: $15/month after trial
- **Privacy**: All data stays local, no telemetry
Purchase and legal information: **https://brass.coppersun.dev/legal**
## 🌟 Why Copper Sun Brass?
Traditional development tools are stateless. AI agents forget context between sessions. Copper Sun Brass solves this by providing:
1. **Persistent Intelligence** - Never lose context between AI sessions
2. **Strategic Thinking** - Goes beyond syntax checking to architectural insights
3. **Adaptive Learning** - Improves understanding of your project over time
4. **AI-Native Design** - Built specifically for AI coding assistants
## 🆘 Getting Help
- **Documentation**: https://brass.coppersun.dev
- **Installation Issues**: Try the troubleshooting guide at https://brass.coppersun.dev/install
- **Support**: support@coppersuncreative.com
## 📊 Status
- **Version**: 2.1.19
- **Status**: Beta
- **Python**: 3.8+
- **License**: Proprietary (see https://brass.coppersun.dev/legal)
## 🙏 Acknowledgments
**Third-Party Services:**
- **Claude API** - AI analysis capabilities (Anthropic PBC)
- **HuggingFace Transformers** - Model infrastructure (Apache 2.0)
**Disclaimer:**
Claude and Claude Code are products of Anthropic PBC. Brass is an independent development intelligence tool that works with various AI coding assistants, including Claude Code, and is not affiliated with Anthropic.
---
**Ready to enhance your AI development workflow?** 🚀
```bash
curl -fsSL https://brass.coppersun.dev/setup | bash
```
*Built with ❤️ for AI agents and the developers who work with them.*
Raw data
{
"_id": null,
"home_page": "https://github.com/coppersun/brass",
"name": "coppersun-brass",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "code-analysis, ai, ml, devops, automation, copper-sun, brass",
"author": "Copper Sun Team",
"author_email": "Copper Sun Team <brass@coppersun.com>",
"download_url": "https://files.pythonhosted.org/packages/1f/62/a02fd8bfbc679b521b116e7881d3a9d09be12445647efbcb12d4f075ad8e/coppersun_brass-2.3.33.tar.gz",
"platform": null,
"description": "# Copper Sun Brass\n\n> \ud83e\udde0 Development Intelligence for AI Agents\n\nCopper Sun Brass is an AI advisory system that acts as a \"General Staff\" for AI agents (like Claude Code) working on software projects. It provides persistent memory, project analysis, and intelligence gathering.\n\n## \ud83d\ude80 Quick Start\n\n### One-Command Installation (Recommended)\n```bash\n# Install and activate trial in one command\ncurl -fsSL https://brass.coppersun.dev/setup | bash\n\n# Navigate to your project and initialize\ncd your-project\nbrass init\n```\n\n### Standard Installation\n```bash\n# Install from PyPI (recommended: pipx for isolated environment)\npipx install coppersun-brass\n\n# Generate and activate 15-day trial\nbrass generate-trial --activate\n\n# Configure Claude API (required)\nbrass config set claude_api_key sk-your-api-key\n\n# Initialize in your project\ncd your-project\nbrass init\n```\n\n### Check Status\n```bash\n# Verify everything is working\nbrass status\n\n# Get AI insights for your project\nbrass insights\n\n# View legal documents\nbrass legal\n```\n\n## \ud83c\udfaf Key Features\n\n### Four Specialized Agents\n\n1. **Watch Agent** \ud83d\udc41\ufe0f - Continuous project monitoring\n2. **Scout Agent** \ud83d\udd0d - Deep code analysis and pattern detection \n3. **Strategist Agent** \ud83c\udfaf - High-level planning and recommendations\n4. **Planner Agent** \ud83d\udccb - Task generation and prioritization\n\n### Core Capabilities\n\n- **Persistent Memory** \ud83d\udcbe - Maintains context across AI sessions\n- **Strategic Planning** \ud83d\udcca - Project analysis and recommendations\n- **Pattern Detection** \ud83d\udd0d - Identifies code patterns and potential issues\n- **File System Monitoring** \ud83d\udce1 - Tracks file changes in real-time\n- **Code Intelligence** \ud83e\udde0 - Security detection and architecture insights\n- **External Integration Framework** \ud83d\udd17 - Ready for Slack, GitHub, webhooks (coming soon)\n- **Privacy-First** \ud83d\udd12 - All data stays local on your machine\n\n## \ud83d\udca1 How It Works\n\nCopper Sun Brass creates a `.brass/` directory in your project containing:\n- **Project context** that persists across AI sessions\n- **Continuous analysis** by four specialized AI agents\n- **Strategic insights** and recommendations\n- **Development patterns** and best practices\n\nWhen you work with Claude Code (or other AI assistants), they can access this context to provide much better, more informed assistance.\n\n## \ud83d\udcd6 Documentation\n\nComplete documentation available at: **https://brass.coppersun.dev**\n\n### Essential Commands\n```bash\nbrass status # Check system status\nbrass init # Initialize project\nbrass insights # Get AI recommendations \nbrass refresh # Update project analysis\nbrass scout scan # Scan for code issues\nbrass legal # View legal documents\nbrass --help # See all commands\n```\n\n## \ud83d\udd27 Requirements\n\n- **Python**: 3.8 or later\n- **Node.js**: 16+ with npm (auto-installs TypeScript analysis dependencies)\n- **Operating System**: macOS, Linux, Windows (WSL)\n- **Claude API Key**: Required for AI functionality\n\n## \ud83d\udee1\ufe0f License & Pricing\n\n- **Free Trial**: 15 days, full features\n- **Pro**: $15/month after trial\n- **Privacy**: All data stays local, no telemetry\n\nPurchase and legal information: **https://brass.coppersun.dev/legal**\n\n## \ud83c\udf1f Why Copper Sun Brass?\n\nTraditional development tools are stateless. AI agents forget context between sessions. Copper Sun Brass solves this by providing:\n\n1. **Persistent Intelligence** - Never lose context between AI sessions\n2. **Strategic Thinking** - Goes beyond syntax checking to architectural insights\n3. **Adaptive Learning** - Improves understanding of your project over time\n4. **AI-Native Design** - Built specifically for AI coding assistants\n\n## \ud83c\udd98 Getting Help\n\n- **Documentation**: https://brass.coppersun.dev\n- **Installation Issues**: Try the troubleshooting guide at https://brass.coppersun.dev/install\n- **Support**: support@coppersuncreative.com\n\n## \ud83d\udcca Status\n\n- **Version**: 2.1.19\n- **Status**: Beta\n- **Python**: 3.8+\n- **License**: Proprietary (see https://brass.coppersun.dev/legal)\n\n## \ud83d\ude4f Acknowledgments\n\n**Third-Party Services:**\n- **Claude API** - AI analysis capabilities (Anthropic PBC)\n- **HuggingFace Transformers** - Model infrastructure (Apache 2.0)\n\n**Disclaimer:**\nClaude and Claude Code are products of Anthropic PBC. Brass is an independent development intelligence tool that works with various AI coding assistants, including Claude Code, and is not affiliated with Anthropic.\n\n---\n\n**Ready to enhance your AI development workflow?** \ud83d\ude80\n\n```bash\ncurl -fsSL https://brass.coppersun.dev/setup | bash\n```\n\n*Built with \u2764\ufe0f for AI agents and the developers who work with them.*\n",
"bugtrack_url": null,
"license": "Proprietary",
"summary": "Development Intelligence for AI Agents - Copper Sun Product Line",
"version": "2.3.33",
"project_urls": {
"Documentation": "https://docs.brass.coppersun.dev",
"Homepage": "https://github.com/coppersun/brass",
"Issues": "https://github.com/coppersun/brass/issues",
"Repository": "https://github.com/coppersun/brass"
},
"split_keywords": [
"code-analysis",
" ai",
" ml",
" devops",
" automation",
" copper-sun",
" brass"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "557d98e104106c2c03641b0f457fd039e146e8b5ce5a2c840fb84395f2924651",
"md5": "a21561d8caef1af993480c73178a6ea9",
"sha256": "70a774f76990ab560a89404bc2996a45af1057a9a00cf609eb68a875f50f318a"
},
"downloads": -1,
"filename": "coppersun_brass-2.3.33-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a21561d8caef1af993480c73178a6ea9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 690252,
"upload_time": "2025-07-28T01:44:21",
"upload_time_iso_8601": "2025-07-28T01:44:21.252912Z",
"url": "https://files.pythonhosted.org/packages/55/7d/98e104106c2c03641b0f457fd039e146e8b5ce5a2c840fb84395f2924651/coppersun_brass-2.3.33-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1f62a02fd8bfbc679b521b116e7881d3a9d09be12445647efbcb12d4f075ad8e",
"md5": "7b2f9e562a535d010d09e19c6f65419c",
"sha256": "85bef75381584eb2dc27d214eaff9f46006e340d5d5b0b788d88e40cfaf25185"
},
"downloads": -1,
"filename": "coppersun_brass-2.3.33.tar.gz",
"has_sig": false,
"md5_digest": "7b2f9e562a535d010d09e19c6f65419c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 652668,
"upload_time": "2025-07-28T01:44:24",
"upload_time_iso_8601": "2025-07-28T01:44:24.335070Z",
"url": "https://files.pythonhosted.org/packages/1f/62/a02fd8bfbc679b521b116e7881d3a9d09be12445647efbcb12d4f075ad8e/coppersun_brass-2.3.33.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-28 01:44:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "coppersun",
"github_project": "brass",
"github_not_found": true,
"lcname": "coppersun-brass"
}
JSON
