Nife CLI Extension for VS Code

A Visual Studio Code extension that provides seamless integration with the Nife.io CLI (nifectl), enabling developers to manage their Nife.io applications directly from their IDE.

Features

• Authentication Management: Login and logout from Nife.io platform
• Application Management: Create, deploy, destroy, and manage Nife.io applications
• Real-time Monitoring: View application logs and metrics
• Configuration Management: Manage application secrets and configuration
• Quick Access: Command palette integration with keyboard shortcuts
• Output Channel: Dedicated output channel for all CLI operations

Prerequisites

Before using this extension, you need to have the nifectl CLI installed on your system.

Installing nifectl

Visit the Nife.io CLI documentation for installation instructions.

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Nife CLI Extension"
4. Click Install

Usage

Command Palette

All commands are available through the VS Code Command Palette (Ctrl+Shift+P / Cmd+Shift+P). Type "Nife:" to see all available commands:

Authentication

• Nife: Login - Authenticate with Nife.io platform
• Nife: Logout - Sign out from Nife.io platform

Application Management

• Nife: Initialize App - Initialize a new Nife.io application in the current directory
• Nife: Create App - Create a new application on Nife.io platform
• Nife: Deploy App - Deploy your application to Nife.io
• Nife: List Apps - List all your applications
• Nife: App Status - Check the status of an application
• Nife: Open App - Open your deployed application in the browser
• Nife: Destroy App - Permanently delete an application

Monitoring & Logs

• Nife: View Logs - View application logs
• Nife: View Metrics - View application metrics

Configuration & Secrets

• Nife: List Secrets - List application secrets
• Nife: Set Secret - Set a new secret for your application

Utilities

• Nife: Open Dashboard - Open Nife.io dashboard in browser
• Nife: Show Version - Display nifectl CLI version
• Nife: Show Output - Show the Nife CLI output channel
• Nife: Clear Output - Clear the output channel

Keyboard Shortcuts

The extension provides convenient keyboard shortcuts for frequently used commands:

• Ctrl+Shift+D (Cmd+Shift+D on Mac): Deploy App
• Ctrl+Shift+L (Cmd+Shift+L on Mac): View Logs
• Ctrl+Shift+O (Cmd+Shift+O on Mac): Show Output Channel

Configuration

The extension automatically detects the nifectl CLI from your system PATH. If the CLI is not found, you'll see a warning message with a link to the installation documentation.

Output Channel

All CLI operations are logged to a dedicated "Nife CLI" output channel. You can view this channel by:

1. Opening the Output panel (View → Output)
2. Selecting "Nife CLI" from the dropdown
3. Or using the "Nife: Show Output" command

Troubleshooting

nifectl CLI not found

If you see a warning that the nifectl CLI is not found:

1. Ensure nifectl is installed on your system
2. Verify that nifectl is in your system PATH
3. Restart VS Code after installing nifectl

Command execution fails

If commands fail to execute:

1. Check the Nife CLI output channel for detailed error messages
2. Ensure you're authenticated with nife auth login
3. Verify your internet connection
4. Check that you have the necessary permissions for the operation

Contributing

This extension is open source. Contributions are welcome!

Support

For issues related to:

• Extension functionality: Create an issue in the extension repository
• Nife.io platform: Visit Nife.io documentation
• nifectl CLI: Check the CLI documentation

License

This extension is licensed under the MIT License.

Changelog

0.0.1

• Initial release
• Basic CLI integration
• Command palette support
• Output channel integration
• Keyboard shortcuts