universal-ai-config 0.1.0__tar.gz

universal_ai_config-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Universal AI Config
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

universal_ai_config-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include universal_ai_config *.md

universal_ai_config-0.1.0/PKG-INFO

@@ -0,0 +1,343 @@
+Metadata-Version: 2.4
+Name: universal-ai-config
+Version: 0.1.0
+Summary: Unified configuration management for AI agents across multiple providers
+Author: DevArts Lab
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/DevArtsLab/tool-universal-ai-config
+Project-URL: Repository, https://github.com/DevArtsLab/tool-universal-ai-config
+Project-URL: Issues, https://github.com/DevArtsLab/tool-universal-ai-config/issues
+Keywords: ai,configuration,devin,windsurf,claude,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: license-file
+
+# Universal AI Configuration
+
+A unified configuration system for AI agents across multiple providers (Devin, Windsurf, Claude, etc.). This tool provides a single source of truth for AI agent settings, skills, MCP servers, and rules.
+
+## Features
+
+- **Unified Configuration**: Single config file for all AI providers
+- **XDG-Compliant**: Follows Linux/macOS/Windows directory standards
+- **Migration Support**: Automatically migrates existing provider configs
+- **Project-Local**: Per-project configuration with `.ai/` directory
+- **Shared Resources**: MCP servers and skills shared across providers
+- **Provider Overrides**: Provider-specific settings when needed
+
+## Installation
+
+### Package Manager (Recommended)
+
+```bash
+# uv (or run without installing: uvx ai-config --help)
+uv tool install universal-ai-config
+
+# pipx
+pipx install universal-ai-config
+
+# pip
+pip install universal-ai-config
+```
+
+### One-Line Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/DevArtsLab/tool-universal-ai-config/main/install.sh | bash
+```
+
+The installer prefers uv or pipx when available, and falls back to a managed
+virtual environment. It will:
+
+- Install the package and set up the `ai-config` command
+- Detect and migrate existing configurations
+- Initialize the unified config structure
+
+### Standalone Binaries
+
+Prebuilt binaries for Linux, macOS (Intel and Apple Silicon), and Windows are
+attached to each [GitHub release](https://github.com/DevArtsLab/tool-universal-ai-config/releases)
+— no Python required.
+
+### Manual Install
+
+```bash
+# Clone the repository
+git clone https://github.com/DevArtsLab/tool-universal-ai-config.git
+cd tool-universal-ai-config
+
+# Install via pip
+pip install -e .
+```
+
+## Quick Start
+
+### New Users
+
+Initialize a fresh configuration:
+
+```bash
+ai-config init
+```
+
+Initialize for a project:
+
+```bash
+cd your-project
+ai-config init-project
+```
+
+### Existing Users
+
+Migrate from existing provider configurations:
+
+```bash
+ai-config migrate
+```
+
+Migrate project-specific configs:
+
+```bash
+cd your-project
+ai-config migrate --project
+```
+
+## Directory Structure
+
+### User-Global Configuration
+
+```
+~/.agents/                  # All agent data in one place
+  ├── config/
+  │   ├── config.json     # Unified config (all providers read this)
+  │   ├── mcp-config.json # MCP servers
+  │   └── AGENTS.md       # Shared rules
+  ├── skills/             # Shared skills
+  │   └── example-skill/
+  ├── data/               # Long-term memory, datasets, plugins
+  │   ├── memory/
+  │   └── plugins/
+  ├── state/              # Logs, history, active sessions
+  │   ├── logs/
+  │   └── history/
+  └── cache/              # Model caches, isolated environments
+      ├── models/
+      └── venv/
+```
+
+### Project-Local Configuration
+
+```
+.ai/                      # In repository root
+  ├── config.json         # Shared team settings
+  ├── config.local.json   # Personal overrides (gitignored)
+  ├── skills/             # Project-specific skills
+  ├── mcp-config.json     # Project MCP servers
+  ├── mcp-config.local.json # Project MCP overrides (gitignored)
+  └── AGENTS.md           # Project rules
+```
+
+## Configuration Format
+
+### Unified Config (`~/.agents/config/config.json`)
+
+```json
+{
+  "shared": {
+    "permissions": {
+      "allow": ["Read(**)", "Exec(git)"],
+      "deny": ["Exec(sudo)"],
+      "ask": ["Write(**/.env*)"]
+    }
+  },
+  "providers": {
+    "devin": {
+      "permissions": {
+        "allow": ["Read(**)", "Exec(git)", "Exec(npm)"]
+      }
+    }
+  },
+  "skills": {
+    "enabled": [],
+    "paths": ["~/.agents/skills/", ".ai/skills/"]
+  }
+}
+```
+
+### MCP Config (`~/.agents/config/mcp-config.json`)
+
+MCP servers are kept in a separate file:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"]
+    }
+  }
+}
+```
+
+## Commands
+
+### `ai-config init [--fresh]`
+
+Initialize new configuration structure.
+
+```bash
+ai-config init           # Initialize new config
+ai-config init --fresh   # Remove existing and start fresh
+```
+
+### `ai-config migrate [provider] [--project]`
+
+Migrate existing provider configurations.
+
+```bash
+ai-config migrate              # Migrate all detected providers
+ai-config migrate devin        # Migrate specific provider
+ai-config migrate --project    # Migrate project configs
+```
+
+### `ai-config validate`
+
+Validate configuration setup.
+
+```bash
+ai-config validate
+```
+
+### `ai-config status`
+
+Show current configuration status.
+
+```bash
+ai-config status
+```
+
+### `ai-config init-project`
+
+Initialize `.ai/` directory in current project.
+
+```bash
+ai-config init-project
+```
+
+### `ai-config get-config <provider>`
+
+Get configuration for a specific provider.
+
+```bash
+ai-config get-config devin
+```
+
+### `ai-config set-config <provider> <key> <value>`
+
+Set configuration value for a provider.
+
+```bash
+ai-config set-config devin model your-model-name
+ai-config set-config devin theme_mode dark
+```
+
+## Provider Integration
+
+Each AI provider should read from the unified configuration:
+
+```python
+from universal_ai_config import UnifiedConfig, AgentEnv
+
+# Initialize
+env = AgentEnv()
+config = UnifiedConfig(env)
+
+# Get provider-specific config
+devin_config = config.get_provider_config("devin")
+
+# Get merged config (user + project)
+merged_config = config.get_merged_config(cwd=Path.cwd())
+```
+
+## Migration Details
+
+The tool automatically detects and migrates from:
+
+- **Devin CLI**: `~/.config/devin/config.json`, `.devin/config.json`
+- **Windsurf**: `~/.windsurf/config.json`, `.windsurf/config.json`
+- **Claude**: `~/.config/claude/config.json`, `.claude/config.json`
+
+Legacy configs are backed up with `.backup` extension.
+
+## Platform Support
+
+- **Linux**: XDG Base Directory Specification
+- **macOS**: XDG paths with `~/.config` fallback
+- **Windows**: `%APPDATA%` and `%LOCALAPPDATA%` paths
+
+## Best Practices
+
+1. **Secrets Management**: Never store API keys in config files. Use system keyrings or environment variables.
+
+2. **Project Config**: Use `.ai/config.json` for team settings and `.ai/config.local.json` for personal overrides.
+
+3. **Shared Resources**: Put common MCP servers and skills in user config; project-specific ones in `.ai/`.
+
+4. **Validation**: Always run `ai-config validate` after making changes.
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/DevArtsLab/tool-universal-ai-config.git
+cd tool-universal-ai-config
+pip install -e ".[dev]"
+```
+
+### Run Tests
+
+```bash
+pytest
+```
+
+### Format Code
+
+```bash
+black universal_ai_config/
+```
+
+### Type Check
+
+```bash
+mypy universal_ai_config/
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please read our contributing guidelines before submitting PRs.
+
+## Support
+
+- GitHub Issues: https://github.com/DevArtsLab/tool-universal-ai-config/issues
+- Documentation: https://github.com/DevArtsLab/tool-universal-ai-config/wiki

universal_ai_config-0.1.0/README.md

@@ -0,0 +1,313 @@
+# Universal AI Configuration
+
+A unified configuration system for AI agents across multiple providers (Devin, Windsurf, Claude, etc.). This tool provides a single source of truth for AI agent settings, skills, MCP servers, and rules.
+
+## Features
+
+- **Unified Configuration**: Single config file for all AI providers
+- **XDG-Compliant**: Follows Linux/macOS/Windows directory standards
+- **Migration Support**: Automatically migrates existing provider configs
+- **Project-Local**: Per-project configuration with `.ai/` directory
+- **Shared Resources**: MCP servers and skills shared across providers
+- **Provider Overrides**: Provider-specific settings when needed
+
+## Installation
+
+### Package Manager (Recommended)
+
+```bash
+# uv (or run without installing: uvx ai-config --help)
+uv tool install universal-ai-config
+
+# pipx
+pipx install universal-ai-config
+
+# pip
+pip install universal-ai-config
+```
+
+### One-Line Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/DevArtsLab/tool-universal-ai-config/main/install.sh | bash
+```
+
+The installer prefers uv or pipx when available, and falls back to a managed
+virtual environment. It will:
+
+- Install the package and set up the `ai-config` command
+- Detect and migrate existing configurations
+- Initialize the unified config structure
+
+### Standalone Binaries
+
+Prebuilt binaries for Linux, macOS (Intel and Apple Silicon), and Windows are
+attached to each [GitHub release](https://github.com/DevArtsLab/tool-universal-ai-config/releases)
+— no Python required.
+
+### Manual Install
+
+```bash
+# Clone the repository
+git clone https://github.com/DevArtsLab/tool-universal-ai-config.git
+cd tool-universal-ai-config
+
+# Install via pip
+pip install -e .
+```
+
+## Quick Start
+
+### New Users
+
+Initialize a fresh configuration:
+
+```bash
+ai-config init
+```
+
+Initialize for a project:
+
+```bash
+cd your-project
+ai-config init-project
+```
+
+### Existing Users
+
+Migrate from existing provider configurations:
+
+```bash
+ai-config migrate
+```
+
+Migrate project-specific configs:
+
+```bash
+cd your-project
+ai-config migrate --project
+```
+
+## Directory Structure
+
+### User-Global Configuration
+
+```
+~/.agents/                  # All agent data in one place
+  ├── config/
+  │   ├── config.json     # Unified config (all providers read this)
+  │   ├── mcp-config.json # MCP servers
+  │   └── AGENTS.md       # Shared rules
+  ├── skills/             # Shared skills
+  │   └── example-skill/
+  ├── data/               # Long-term memory, datasets, plugins
+  │   ├── memory/
+  │   └── plugins/
+  ├── state/              # Logs, history, active sessions
+  │   ├── logs/
+  │   └── history/
+  └── cache/              # Model caches, isolated environments
+      ├── models/
+      └── venv/
+```
+
+### Project-Local Configuration
+
+```
+.ai/                      # In repository root
+  ├── config.json         # Shared team settings
+  ├── config.local.json   # Personal overrides (gitignored)
+  ├── skills/             # Project-specific skills
+  ├── mcp-config.json     # Project MCP servers
+  ├── mcp-config.local.json # Project MCP overrides (gitignored)
+  └── AGENTS.md           # Project rules
+```
+
+## Configuration Format
+
+### Unified Config (`~/.agents/config/config.json`)
+
+```json
+{
+  "shared": {
+    "permissions": {
+      "allow": ["Read(**)", "Exec(git)"],
+      "deny": ["Exec(sudo)"],
+      "ask": ["Write(**/.env*)"]
+    }
+  },
+  "providers": {
+    "devin": {
+      "permissions": {
+        "allow": ["Read(**)", "Exec(git)", "Exec(npm)"]
+      }
+    }
+  },
+  "skills": {
+    "enabled": [],
+    "paths": ["~/.agents/skills/", ".ai/skills/"]
+  }
+}
+```
+
+### MCP Config (`~/.agents/config/mcp-config.json`)
+
+MCP servers are kept in a separate file:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"]
+    }
+  }
+}
+```
+
+## Commands
+
+### `ai-config init [--fresh]`
+
+Initialize new configuration structure.
+
+```bash
+ai-config init           # Initialize new config
+ai-config init --fresh   # Remove existing and start fresh
+```
+
+### `ai-config migrate [provider] [--project]`
+
+Migrate existing provider configurations.
+
+```bash
+ai-config migrate              # Migrate all detected providers
+ai-config migrate devin        # Migrate specific provider
+ai-config migrate --project    # Migrate project configs
+```
+
+### `ai-config validate`
+
+Validate configuration setup.
+
+```bash
+ai-config validate
+```
+
+### `ai-config status`
+
+Show current configuration status.
+
+```bash
+ai-config status
+```
+
+### `ai-config init-project`
+
+Initialize `.ai/` directory in current project.
+
+```bash
+ai-config init-project
+```
+
+### `ai-config get-config <provider>`
+
+Get configuration for a specific provider.
+
+```bash
+ai-config get-config devin
+```
+
+### `ai-config set-config <provider> <key> <value>`
+
+Set configuration value for a provider.
+
+```bash
+ai-config set-config devin model your-model-name
+ai-config set-config devin theme_mode dark
+```
+
+## Provider Integration
+
+Each AI provider should read from the unified configuration:
+
+```python
+from universal_ai_config import UnifiedConfig, AgentEnv
+
+# Initialize
+env = AgentEnv()
+config = UnifiedConfig(env)
+
+# Get provider-specific config
+devin_config = config.get_provider_config("devin")
+
+# Get merged config (user + project)
+merged_config = config.get_merged_config(cwd=Path.cwd())
+```
+
+## Migration Details
+
+The tool automatically detects and migrates from:
+
+- **Devin CLI**: `~/.config/devin/config.json`, `.devin/config.json`
+- **Windsurf**: `~/.windsurf/config.json`, `.windsurf/config.json`
+- **Claude**: `~/.config/claude/config.json`, `.claude/config.json`
+
+Legacy configs are backed up with `.backup` extension.
+
+## Platform Support
+
+- **Linux**: XDG Base Directory Specification
+- **macOS**: XDG paths with `~/.config` fallback
+- **Windows**: `%APPDATA%` and `%LOCALAPPDATA%` paths
+
+## Best Practices
+
+1. **Secrets Management**: Never store API keys in config files. Use system keyrings or environment variables.
+
+2. **Project Config**: Use `.ai/config.json` for team settings and `.ai/config.local.json` for personal overrides.
+
+3. **Shared Resources**: Put common MCP servers and skills in user config; project-specific ones in `.ai/`.
+
+4. **Validation**: Always run `ai-config validate` after making changes.
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/DevArtsLab/tool-universal-ai-config.git
+cd tool-universal-ai-config
+pip install -e ".[dev]"
+```
+
+### Run Tests
+
+```bash
+pytest
+```
+
+### Format Code
+
+```bash
+black universal_ai_config/
+```
+
+### Type Check
+
+```bash
+mypy universal_ai_config/
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please read our contributing guidelines before submitting PRs.
+
+## Support
+
+- GitHub Issues: https://github.com/DevArtsLab/tool-universal-ai-config/issues
+- Documentation: https://github.com/DevArtsLab/tool-universal-ai-config/wiki