CF Targets Plugin

Easily manage multiple Cloud Foundry API targets with seamless switching and saving.

This plugin simplifies working with multiple CF environments by allowing you to save, switch, and manage different API targets effortlessly. Perfect for developers working across development, staging, and production environments.

✨ Features

• Save Multiple Targets: Store unlimited CF API targets with custom names
• Quick Switching: Switch between environments with a single command
• Smart Diff Display: See exactly what changes when switching targets
• Cross-Platform: Works on Linux, macOS, and Windows (Intel & ARM)
• Secure: Redacts sensitive tokens in diff output
• Easy Installation: One-command npm installation with automatic CF CLI registration

🚀 Quick Start

1. Install the Plugin

npm install -g @cf-plugins/cf-targets-plugin

2. Save Your First Target

cf api https://api.your-dev-environment.com
cf login
cf save-target development

3. Save Additional Targets

cf api https://api.your-prod-environment.com  
cf login
cf save-target production

4. Switch Between Targets

cf set-target development
cf set-target production

That's it! You're now managing multiple CF environments like a pro.

📖 Usage Examples

Save Current Target

# Save with a custom name
cf save-target my-dev-env

# Update existing target (with confirmation)
cf save-target production -f

Switch Targets

# Switch to saved target
cf set-target production

# Force switch (discards unsaved changes)
cf set-target development -f

List All Targets

cf targets

Output:

development
production (current)
staging

Delete Unused Targets

cf delete-target old-environment

📋 Commands Reference

Command	Usage	Description
targets	cf targets	List all saved targets
save-target	cf save-target [-f] [NAME]	Save current target
set-target	cf set-target [-f] NAME	Switch to saved target
delete-target	cf delete-target NAME	Delete saved target

Command Options

• -f, --force: Override confirmations and force the operation

🔧 Installation Options

Option 1: NPM (Recommended)

npm install -g @cf-plugins/cf-targets-plugin

The plugin automatically registers with CF CLI during installation.

Option 2: Manual Binary Installation

1. Download binary from Releases
2. Make executable: chmod +x cf-targets-plugin-*
3. Install: cf install-plugin /path/to/binary -f

Option 3: Build from Source

git clone https://github.com/Amit-A2Z/cf-targets-plugin.git
cd cf-targets-plugin
make build
cf install-plugin cf-targets-plugin -f

🛠 Troubleshooting

Plugin Not Showing in cf plugins

# Check if plugin is installed
cf plugins | grep cf-targets

# If not found, manually register
cf install-plugin ~/.nvm/versions/node/*/lib/node_modules/@cf-plugins/cf-targets-plugin/bin/cf-targets-plugin -f

# Verify installation
cf plugins

Permission Denied Errors

# Make binary executable
chmod +x ~/.nvm/versions/node/*/lib/node_modules/@cf-plugins/cf-targets-plugin/bin/cf-targets-plugin

CF CLI Not Found During Installation

1. Install CF CLI: https://docs.cloudfoundry.org/cf-cli/install-go-cli.html
2. Reinstall plugin: npm install -g @cf-plugins/cf-targets-plugin

🏗 Building from Source

Requirements

• Go 1.25 or later
• Cloud Foundry CLI

Build Commands

# Build for current platform
make build

# Build for all platforms
make release-all

# Install locally
make install

🌍 Supported Platforms

Platform	Architecture	Status
Linux	AMD64	✅ Supported
Linux	ARM64	✅ Supported
macOS	Intel (AMD64)	✅ Supported
macOS	Apple Silicon (ARM64)	✅ Supported
Windows	AMD64	✅ Supported
Windows	ARM64	✅ Supported

🤝 Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Note: This software is provided "AS IS" without warranty of any kind. Use at your own discretion.

---

Need help? Check out the Issues page or create a new issue for support.