JIRA slash command
Adds a 'jira' slash command to fetch a JIRA issue by key and include it in context as a JSON object.
How to install
With Forge Super installed, the button above opens the app on this extension, where you press Install. Nothing is installed until you do.
You can also open the Extensions panel in the app and search for JIRA slash command. The extension's id is jira-slash-command.
Don't have Forge Super yet? Download it here.
README
From the extension's repository, written by its authors and not by Mentenaz. See the source.
JIRA Slash Command for Zed
A Zed editor extension that adds a /jira slash command to fetch JIRA issues and insert them as nicely formatted JSON.
Features
- Fetch JIRA issues directly from within Zed
- Insert issue data as well-formatted JSON
- Include key issue details like summary, description, type, status, and comments
- Secure authentication using JIRA API tokens
Installation
From the Extension Registry
- Open Zed
- Press
Cmd+Shift+P(Mac) orCtrl+Shift+P(Windows/Linux) to open the command palette - Type "Extensions: Install Extension"
- Search for "JIRA Slash Command"
- Click "Install"
Manual Installation
git clone https://github.com/trbroyles1/jira-slash-command.git
cd jira-slash-command
cargo build --release
Then copy the resulting .wasm file to your Zed extensions directory.
Configuration
This extension requires three environment variables to be set:
| Variable | Description |
|---|---|
JIRA_URL | Base URL for your JIRA instance (e.g., https://your-domain.atlassian.net) |
JIRA_USER | Your JIRA username (typically your email address) |
JIRA_API_TOKEN | Your JIRA API token (create one in Atlassian Account Settings) |
Usage
- Open a workspace in Zed
- Type
/jirafollowed by the issue key:/jira PROJECT-123 - Press Enter
- The issue details will be inserted as formatted JSON
Example Output
{
"issue_key": "PROJECT-123",
"type": "Story",
"summary": "Implement the new login flow",
"description": "As a user, I want to be able to log in using my social accounts",
"createdAt": "2023-06-15T14:53:00.000Z",
"reporter": "Jane Smith",
"assignee": "John Doe",
"status": "In Progress",
"comments": [
{
"timestamp": "2023-06-16T09:32:00.000Z",
"author": "Bob Johnson",
"body": "Should we add support for Google authentication as well?"
}
]
}
Requirements
- Zed v0.105.0 or higher
- Valid JIRA API credentials
Development
Building from Source
# Clone the repository
git clone https://github.com/trbroyles1/jira-slash-command.git
# Navigate to the directory
cd jira-slash-command
# Build the extension
cargo build --release
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the BSD-3-Clause License - see the LICENSE file for details.
Acknowledgments
- The Zed Editor team, for Zed
- Atlassian for the JIRA API