ai-account-switch 1.1.0

package/.claude/settings.local.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(node:*)",
+      "Bash(npm --version)",
+      "Bash(chmod:*)",
+      "Bash(npm install)",
+      "Bash(npm link)",
+      "Bash(ais:*)",
+      "WebSearch",
+      "WebFetch(domain:www.vibesparking.com)",
+      "Read(//Users/deanwang/.claude/**)",
+      "Read(//Users/deanwang/IdeaProjects/githubProject/team-nav/**)",
+      "Bash(cat:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/NPM_PUBLISH.md

@@ -0,0 +1,334 @@
+# NPM Publishing Guide
+
+This guide explains how to publish `ai-account-switch` to npm registry.
+
+## Prerequisites
+
+### 1. Create npm Account
+
+If you don't have an npm account:
+
+1. Go to https://www.npmjs.com/signup
+2. Create your account
+3. Verify your email
+
+### 2. Login to npm
+
+Login via command line:
+
+```bash
+npm login
+```
+
+Enter your:
+- Username
+- Password
+- Email
+- One-time password (if 2FA is enabled)
+
+Verify you're logged in:
+
+```bash
+npm whoami
+```
+
+## Before Publishing
+
+### 1. Update Package Information
+
+Edit `package.json`:
+
+```json
+{
+  "name": "ai-account-switch",
+  "version": "1.1.0",
+  "author": "Your Name <your.email@example.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/ai-agent-user-swith.git"
+  }
+}
+```
+
+### 2. Check Package Name Availability
+
+```bash
+npm view ai-account-switch
+```
+
+If it returns an error, the name is available. If not, choose a different name like:
+- `@yourusername/ai-account-switch` (scoped package)
+- `ais-cli`
+- `claude-account-switch`
+
+### 3. Test Package Locally
+
+```bash
+# Install dependencies
+npm install
+
+# Test the CLI works
+npm link
+ais --version
+ais --help
+
+# Clean up
+npm unlink
+```
+
+### 4. Dry Run
+
+Test what will be published:
+
+```bash
+npm pack --dry-run
+```
+
+Or create a tarball to inspect:
+
+```bash
+npm pack
+tar -xzf ai-account-switch-1.1.0.tgz
+ls package/
+```
+
+## Publishing
+
+### First Time Publication
+
+```bash
+# Make sure you're on the main branch
+git checkout main
+
+# Make sure everything is committed
+git status
+
+# Publish to npm
+npm publish
+```
+
+For scoped packages:
+
+```bash
+npm publish --access public
+```
+
+### Updating a Published Package
+
+1. **Update version number** in `package.json`:
+
+```bash
+# Patch version (1.1.0 -> 1.1.1)
+npm version patch
+
+# Minor version (1.1.0 -> 1.2.0)
+npm version minor
+
+# Major version (1.1.0 -> 2.0.0)
+npm version major
+```
+
+This command will:
+- Update `package.json`
+- Create a git commit
+- Create a git tag
+
+2. **Push changes and tags**:
+
+```bash
+git push
+git push --tags
+```
+
+3. **Publish to npm**:
+
+```bash
+npm publish
+```
+
+## After Publishing
+
+### 1. Verify Publication
+
+Check on npm website:
+```
+https://www.npmjs.com/package/ai-account-switch
+```
+
+Or via CLI:
+```bash
+npm view ai-account-switch
+```
+
+### 2. Test Installation
+
+Test in a clean environment:
+
+```bash
+# Install globally
+npm install -g ai-account-switch
+
+# Test it works
+ais --version
+ais --help
+
+# Uninstall
+npm uninstall -g ai-account-switch
+```
+
+### 3. Update README
+
+Update installation instructions to reflect the published package:
+
+```markdown
+### Option 3: Global npm Installation
+
+\`\`\`bash
+npm install -g ai-account-switch
+\`\`\`
+```
+
+## Automation with GitHub Actions
+
+### Option 1: Automatic NPM Publish on Release
+
+Create `.github/workflows/npm-publish.yml`:
+
+```yaml
+name: Publish to NPM
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm ci
+
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+### Setup NPM Token in GitHub:
+
+1. Generate NPM token:
+   ```bash
+   npm token create
+   ```
+
+2. Add to GitHub:
+   - Go to your repository on GitHub
+   - Settings → Secrets and variables → Actions
+   - New repository secret
+   - Name: `NPM_TOKEN`
+   - Value: (paste your npm token)
+
+## Troubleshooting
+
+### Package Name Already Taken
+
+Use a scoped package:
+
+```json
+{
+  "name": "@yourusername/ai-account-switch"
+}
+```
+
+### Permission Denied
+
+Make sure you're logged in:
+```bash
+npm whoami
+npm login
+```
+
+### 2FA Required
+
+If you have 2FA enabled, you need to:
+
+1. Generate an automation token on npmjs.com
+2. Use it for CI/CD publishing
+
+### Version Already Published
+
+You cannot republish the same version. Update version:
+
+```bash
+npm version patch
+npm publish
+```
+
+## Best Practices
+
+1. **Semantic Versioning**: Follow semver (MAJOR.MINOR.PATCH)
+2. **Test Before Publishing**: Always test locally first
+3. **Keep README Updated**: Ensure documentation is current
+4. **Changelog**: Maintain a changelog in README.md
+5. **Clean Package**: Use `.npmignore` to exclude unnecessary files
+6. **License**: Include appropriate license (MIT)
+
+## Unpublishing (Emergency Only)
+
+**Warning**: Only unpublish in emergency situations (security issues, etc.)
+
+```bash
+# Unpublish specific version
+npm unpublish ai-account-switch@1.1.0
+
+# Unpublish all versions (within 72 hours of publish)
+npm unpublish ai-account-switch --force
+```
+
+After 72 hours, you cannot unpublish. Instead, publish a new version.
+
+## Package Maintenance
+
+### Deprecate a Version
+
+```bash
+npm deprecate ai-account-switch@1.0.0 "Please upgrade to 1.1.0"
+```
+
+### Add Collaborators
+
+```bash
+npm owner add username ai-account-switch
+```
+
+### View Package Stats
+
+```bash
+npm view ai-account-switch
+
+# Download stats
+npm view ai-account-switch time
+```
+
+## Checklist Before Publishing
+
+- [ ] All tests pass
+- [ ] Version number updated
+- [ ] README.md is current
+- [ ] CHANGELOG updated
+- [ ] `.npmignore` configured
+- [ ] `package.json` has correct info
+- [ ] Tested with `npm pack`
+- [ ] Logged into npm
+- [ ] Git committed and pushed
+
+## Resources
+
+- [npm Documentation](https://docs.npmjs.com/)
+- [Semantic Versioning](https://semver.org/)
+- [npm Publishing Guide](https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry)

package/README.md

@@ -0,0 +1,378 @@
+# AI Account Switch (ais)
+
+A cross-platform CLI tool to manage and switch between Claude/Codex account configurations for different projects.
+
+## Features
+
+- **Cross-Platform**: Works seamlessly on macOS, Linux, and Windows
+- **Multiple Accounts**: Store and manage multiple AI service accounts
+- **Project-Specific**: Each project can use a different account
+- **Smart Directory Detection**: Works in any subdirectory of your project (like git)
+- **Claude Code Integration**: Automatically generates `.claude/settings.local.json` for Claude Code CLI
+- **Secure Storage**: Account credentials stored locally in your home directory
+- **Interactive CLI**: Easy-to-use interactive prompts for all operations
+- **Account Types**: Support for Claude, Codex, and other AI services
+
+## Installation
+
+### Option 1: Download Pre-built Binary (Recommended)
+
+Download the latest release for your platform from the [Releases page](https://github.com/yourusername/ai-agent-user-swith/releases):
+
+**macOS:**
+```bash
+# Download and install
+curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-macos -o /usr/local/bin/ais
+chmod +x /usr/local/bin/ais
+```
+
+**Linux:**
+```bash
+# Download and install
+curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-linux -o /usr/local/bin/ais
+chmod +x /usr/local/bin/ais
+```
+
+**Windows:**
+Download `ais-win.exe` from the releases page and add it to your PATH.
+
+### Option 2: Install from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/ai-agent-user-swith.git
+cd ai-agent-user-swith
+
+# Install dependencies
+npm install
+
+# Link the CLI tool globally
+npm link
+```
+
+### Option 3: Global npm Installation
+
+```bash
+npm install -g ai-account-switch
+```
+
+After installation, the `ais` command will be available globally.
+
+**Note**: See [NPM_PUBLISH.md](NPM_PUBLISH.md) for publishing instructions if you're a maintainer.
+
+## Usage
+
+### Commands Overview
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `ais add [name]` | - | Add a new account configuration |
+| `ais list` | `ls` | List all available accounts |
+| `ais use [name]` | - | Set account for current project |
+| `ais info` | - | Show current project's account info |
+| `ais current` | - | Show current account name |
+| `ais remove [name]` | `rm` | Remove an account |
+| `ais paths` | - | Show configuration file paths |
+| `ais export <name>` | - | Export account as JSON |
+| `ais help` | - | Display help information |
+| `ais --version` | - | Show version number |
+
+### Quick Start
+
+#### 1. Add an Account
+
+Add your first account interactively:
+
+```bash
+ais add
+```
+
+Or specify a name directly:
+
+```bash
+ais add my-claude-account
+```
+
+You'll be prompted to enter:
+- Account type (Claude, Codex, Other)
+- API Key
+- API URL (optional)
+- Organization ID (optional)
+- Email (optional)
+- Description (optional)
+
+#### 2. List All Accounts
+
+View all your configured accounts:
+
+```bash
+ais list
+# or
+ais ls
+```
+
+The active account for the current project will be marked with a green dot.
+
+#### 3. Switch Account for Current Project
+
+Set which account to use in your current project:
+
+```bash
+ais use my-claude-account
+```
+
+Or select interactively:
+
+```bash
+ais use
+```
+
+**Note:** This command automatically generates `.claude/settings.local.json` for Claude Code CLI integration.
+You can run this command from any subdirectory within your project - it will automatically find the project root.
+
+#### 4. Check Current Project Info
+
+See which account is active for your current project:
+
+```bash
+ais info
+```
+
+Or just show the account name:
+
+```bash
+ais current
+```
+
+**Note:** These commands work from any subdirectory within your project, similar to how git commands work.
+
+#### 5. Remove an Account
+
+Remove an account you no longer need:
+
+```bash
+ais remove old-account
+# or
+ais rm
+```
+
+### Advanced Usage
+
+#### Show Configuration Paths
+
+See where your configurations are stored:
+
+```bash
+ais paths
+```
+
+#### Export Account Configuration
+
+Export an account's configuration as JSON:
+
+```bash
+ais export my-claude-account
+```
+
+## Configuration
+
+### Global Configuration
+
+All accounts are stored globally in your home directory:
+
+- **macOS/Linux**: `~/.ai-account-switch/config.json`
+- **Windows**: `%USERPROFILE%\.ai-account-switch\config.json`
+
+### Project Configuration
+
+Each project stores its active account reference in:
+
+```
+./.ais-project-config
+```
+
+This file is created automatically when you run `ais use` and should be added to `.gitignore`.
+
+### Claude Code Integration
+
+When you run `ais use`, the tool automatically creates `.claude/settings.local.json` with the following structure:
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
+    "ANTHROPIC_BASE_URL": "your-api-url",
+    "ANTHROPIC_ORGANIZATION_ID": "your-org-id"
+  },
+  "permissions": {
+    "allow": [],
+    "deny": [],
+    "ask": []
+  }
+}
+```
+
+This ensures Claude Code CLI automatically uses the correct account for your project.
+
+## Examples
+
+### Example 1: Setting Up Multiple Accounts
+
+```bash
+# Add your personal Claude account
+ais add personal-claude
+
+# Add your work Claude account
+ais add work-claude
+
+# Add a Codex account
+ais add codex-dev
+
+# List all accounts
+ais list
+```
+
+### Example 2: Using Different Accounts for Different Projects
+
+```bash
+# In your personal project
+cd ~/my-personal-project
+ais use personal-claude
+
+# In your work project
+cd ~/work/company-project
+ais use work-claude
+
+# Check what's active
+ais info
+```
+
+### Example 3: Managing Accounts
+
+```bash
+# View all accounts
+ais list
+
+# Check current account
+ais current
+
+# Export an account config
+ais export personal-claude
+
+# Remove old accounts
+ais remove old-account
+
+# View config locations
+ais paths
+```
+
+## Security Notes
+
+- API keys are stored locally on your machine only
+- The global configuration file contains sensitive credentials
+- Always add `.ais-project-config` to your `.gitignore`
+- Never commit account credentials to version control
+- API keys are masked when displayed (shows first and last 4 characters only)
+
+## Platform Compatibility
+
+| Platform | Status | Notes |
+|----------|--------|-------|
+| macOS | ✅ Fully Supported | Tested on macOS 10.15+ |
+| Linux | ✅ Fully Supported | Tested on Ubuntu 20.04+ |
+| Windows | ✅ Fully Supported | Tested on Windows 10+ |
+
+## Requirements
+
+- Node.js >= 14.0.0
+- npm >= 6.0.0
+
+## Project Structure
+
+```
+ai-agent-user-swith/
+├── bin/
+│   └── ais.js              # Executable entry point
+├── src/
+│   ├── index.js            # Main CLI program
+│   ├── commands.js         # Command implementations
+│   └── config.js           # Configuration manager
+├── package.json
+├── .gitignore
+└── README.md
+```
+
+## Troubleshooting
+
+### Command not found: ais
+
+If you get this error after installation, make sure you've linked the package:
+
+```bash
+npm link
+```
+
+### Permission denied
+
+On Unix systems, ensure the bin file is executable:
+
+```bash
+chmod +x bin/ais.js
+```
+
+### No accounts found
+
+Make sure you've added at least one account:
+
+```bash
+ais add
+```
+
+## Contributing
+
+Contributions are welcome! Feel free to:
+- Report bugs
+- Suggest new features
+- Submit pull requests
+
+## License
+
+MIT License - feel free to use this tool in your projects!
+
+## Changelog
+
+### v1.1.0
+- Added smart directory detection (works in any subdirectory)
+- Automatic Claude Code `.claude/settings.local.json` generation
+- Project root display in `ais info` command
+- Improved cross-platform compatibility
+
+### v1.0.0
+- Initial release
+- Basic account management (add, list, remove)
+- Project-specific account switching
+- Cross-platform support
+- Interactive CLI prompts
+- Account export functionality
+
+## Future Enhancements
+
+Potential features for future versions:
+- Account validation
+- Bulk import/export
+- Account templates
+- Environment variable export
+- Account sharing (encrypted)
+- Cloud sync support
+- Account usage statistics
+
+## Support
+
+If you encounter any issues or have questions:
+1. Check the troubleshooting section
+2. Review existing issues
+3. Create a new issue with detailed information
+
+---
+
+**Happy coding with your AI assistants!** 🤖

package/bin/ais.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../src/index.js');