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 --releaseThen 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 --releaseContributing
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