v1.1.0: Add jira-create command with multiline description support

- Create Jira issues from CLI with --project, --summary, --type
- --description for inline, --description-file for file/stdin multiline
- Optional --priority and --assignee flags
- 110 tests, 100% coverage

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: raivil

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## v1.1.0 (2026-03-31)
+
+### Added
+- `jira-create` command to create Jira issues from the CLI
+- Multiline description support via `--description-file` (reads from file or stdin with `-`)
+- `--description` and `--description-file` are mutually exclusive
+- Optional `--priority` and `--assignee` flags
+- `make jira-create` target
+- 110 tests with 100% coverage
+
 ## v1.0.1 (2026-03-23)
 
 ### Fixed

Makefile

@@ -1,4 +1,4 @@
-.PHONY: setup build clean test test-cov wiki-export wiki-update wiki-create jira-get jira-my-tasks jira-transition
+.PHONY: setup build clean test test-cov wiki-export wiki-update wiki-create jira-create jira-get jira-my-tasks jira-transition
 
 setup: ## Install dependencies and create venv
 	uv sync
@@ -30,6 +30,11 @@ wiki-create: ## Create a wiki page. Usage: make wiki-create SPACE=<key> TITLE="<
 	@if [ -z "$(INPUT)" ]; then echo "Error: INPUT is required."; exit 1; fi
 	uv run atlassian-local-cli wiki-create $(SPACE) "$(TITLE)" $(INPUT) $(if $(PARENT),--parent $(PARENT))
 
+jira-create: ## Create a Jira issue. Usage: make jira-create PROJECT=<key> SUMMARY="<text>" [TYPE=Task] [PRIORITY=High] [ASSIGNEE=user] [DESCRIPTION="<text>"] [DESC_FILE=<file>]
+	@if [ -z "$(PROJECT)" ]; then echo "Error: PROJECT is required."; exit 1; fi
+	@if [ -z "$(SUMMARY)" ]; then echo "Error: SUMMARY is required."; exit 1; fi
+	uv run atlassian-local-cli jira-create --project $(PROJECT) --summary "$(SUMMARY)" $(if $(TYPE),--type $(TYPE)) $(if $(PRIORITY),--priority $(PRIORITY)) $(if $(ASSIGNEE),--assignee $(ASSIGNEE)) $(if $(DESCRIPTION),--description "$(DESCRIPTION)") $(if $(DESC_FILE),--description-file $(DESC_FILE))
+
 jira-get: ## Get a Jira issue. Usage: make jira-get ISSUE=<key>
 	@if [ -z "$(ISSUE)" ]; then echo "Error: ISSUE is required."; exit 1; fi
 	uv run atlassian-local-cli jira-get $(ISSUE)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atlassian-local-cli"
-version = "1.0.1"
+version = "1.1.0"
 description = "CLI to interact with Confluence and Jira from the command line"
 readme = "README.md"
 requires-python = ">=3.13"

src/atlassian_local_cli/cli.py

@@ -1,6 +1,6 @@
 import argparse
 
-from .jira_commands import jira_get, jira_my_tasks, jira_transition
+from .jira_commands import jira_create, jira_get, jira_my_tasks, jira_transition
 from .wiki import wiki_create, wiki_export, wiki_update
 
 
@@ -25,6 +25,16 @@ def main():
     p.add_argument("--parent", help="Parent page ID (optional)")
     p.set_defaults(func=wiki_create)
 
+    p = subparsers.add_parser("jira-create", help="Create a new Jira issue")
+    p.add_argument("--project", required=True, help="Project key (e.g. PROJ)")
+    p.add_argument("--summary", required=True, help="Issue summary/title")
+    p.add_argument("--type", default="Task", help="Issue type (default: Task)")
+    p.add_argument("--description", help="Inline description")
+    p.add_argument("--description-file", help="Read description from file (use '-' for stdin)")
+    p.add_argument("--priority", help="Priority (Highest, High, Medium, Low, Lowest)")
+    p.add_argument("--assignee", help="Username to assign")
+    p.set_defaults(func=jira_create)
+
     p = subparsers.add_parser("jira-get", help="Display a Jira issue")
     p.add_argument("issue_key", help="Issue key (e.g. PROJ-123)")
     p.set_defaults(func=jira_get)

src/atlassian_local_cli/jira_commands.py

@@ -2,6 +2,7 @@
 import sys
 
 from .clients import create_jira
+from .config import get_config
 
 
 def build_jql(status="open", status_name=None, issue_type=None, project=None):
@@ -25,6 +26,45 @@ def build_jql(status="open", status_name=None, issue_type=None, project=None):
     return " AND ".join(conditions) + " ORDER BY priority DESC, updated DESC"
 
 
+def _resolve_description(args):
+    """Resolve description from --description or --description-file (supports stdin via '-')."""
+    if args.description and args.description_file:
+        print("Error: --description and --description-file are mutually exclusive.", file=sys.stderr)
+        sys.exit(1)
+
+    if args.description_file:
+        if args.description_file == "-":
+            return sys.stdin.read()
+        with open(args.description_file, "r", encoding="utf-8") as f:
+            return f.read()
+
+    return args.description
+
+
+def jira_create(args):
+    description = _resolve_description(args)
+
+    fields = {
+        "project": {"key": args.project},
+        "summary": args.summary,
+        "issuetype": {"name": args.type},
+    }
+    if description:
+        fields["description"] = description
+    if args.priority:
+        fields["priority"] = {"name": args.priority}
+    if args.assignee:
+        fields["assignee"] = {"name": args.assignee}
+
+    jira = create_jira()
+    result = jira.issue_create(fields=fields)
+
+    issue_key = result["key"]
+    config = get_config()
+    print(f"Created {issue_key}: {args.summary}")
+    print(f"{config.jira_url.rstrip('/')}/browse/{issue_key}")
+
+
 def jira_get(args):
     jira = create_jira()
     issue = jira.issue(args.issue_key)

tests/test_jira_commands.py

@@ -6,6 +6,7 @@
 
 from atlassian_local_cli.jira_commands import (
     build_jql,
+    jira_create,
     jira_get,
     jira_my_tasks,
     jira_transition,
@@ -173,3 +174,101 @@ def test_invalid_transition_exits(self, mock_create):
 
         with pytest.raises(SystemExit):
             jira_transition(Namespace(issue_key="PROJ-1", status="invalid"))
+
+
+class TestJiraCreate:
+    @patch("atlassian_local_cli.jira_commands.get_config")
+    @patch("atlassian_local_cli.jira_commands.create_jira")
+    def test_basic_create(self, mock_create, mock_config, capsys):
+        mock_config.return_value = MagicMock(jira_url="https://jira.test.com/")
+        mock_jira = MagicMock()
+        mock_jira.issue_create.return_value = {"key": "PROJ-99"}
+        mock_create.return_value = mock_jira
+
+        args = Namespace(
+            project="PROJ", summary="New task", type="Task",
+            description="Short desc", description_file=None,
+            priority=None, assignee=None,
+        )
+        jira_create(args)
+        output = capsys.readouterr().out
+        assert "PROJ-99" in output
+        assert "New task" in output
+
+        fields = mock_jira.issue_create.call_args[1]["fields"]
+        assert fields["project"] == {"key": "PROJ"}
+        assert fields["summary"] == "New task"
+        assert fields["description"] == "Short desc"
+
+    @patch("atlassian_local_cli.jira_commands.get_config")
+    @patch("atlassian_local_cli.jira_commands.create_jira")
+    def test_with_priority_and_assignee(self, mock_create, mock_config):
+        mock_config.return_value = MagicMock(jira_url="https://jira.test.com/")
+        mock_jira = MagicMock()
+        mock_jira.issue_create.return_value = {"key": "PROJ-100"}
+        mock_create.return_value = mock_jira
+
+        args = Namespace(
+            project="PROJ", summary="Bug", type="Bug",
+            description=None, description_file=None,
+            priority="High", assignee="jdoe",
+        )
+        jira_create(args)
+
+        fields = mock_jira.issue_create.call_args[1]["fields"]
+        assert fields["priority"] == {"name": "High"}
+        assert fields["assignee"] == {"name": "jdoe"}
+        assert "description" not in fields
+
+    @patch("atlassian_local_cli.jira_commands.get_config")
+    @patch("atlassian_local_cli.jira_commands.create_jira")
+    def test_description_from_file(self, mock_create, mock_config, tmp_path):
+        mock_config.return_value = MagicMock(jira_url="https://jira.test.com/")
+        mock_jira = MagicMock()
+        mock_jira.issue_create.return_value = {"key": "PROJ-101"}
+        mock_create.return_value = mock_jira
+
+        desc_file = tmp_path / "desc.md"
+        desc_file.write_text("Line 1\n\nLine 2\n\n- bullet\n- items")
+
+        args = Namespace(
+            project="PROJ", summary="From file", type="Task",
+            description=None, description_file=str(desc_file),
+            priority=None, assignee=None,
+        )
+        jira_create(args)
+
+        fields = mock_jira.issue_create.call_args[1]["fields"]
+        assert "Line 1" in fields["description"]
+        assert "Line 2" in fields["description"]
+        assert "- bullet" in fields["description"]
+
+    @patch("atlassian_local_cli.jira_commands.get_config")
+    @patch("atlassian_local_cli.jira_commands.create_jira")
+    def test_description_from_stdin(self, mock_create, mock_config, monkeypatch):
+        mock_config.return_value = MagicMock(jira_url="https://jira.test.com/")
+        mock_jira = MagicMock()
+        mock_jira.issue_create.return_value = {"key": "PROJ-102"}
+        mock_create.return_value = mock_jira
+
+        import io
+        monkeypatch.setattr("sys.stdin", io.StringIO("Piped\nmultiline\ncontent"))
+
+        args = Namespace(
+            project="PROJ", summary="From stdin", type="Task",
+            description=None, description_file="-",
+            priority=None, assignee=None,
+        )
+        jira_create(args)
+
+        fields = mock_jira.issue_create.call_args[1]["fields"]
+        assert "Piped\nmultiline\ncontent" == fields["description"]
+
+    def test_description_and_file_mutually_exclusive(self):
+        args = Namespace(
+            project="PROJ", summary="Test", type="Task",
+            description="inline", description_file="file.md",
+            priority=None, assignee=None,
+        )
+        with pytest.raises(SystemExit):
+            jira_create(args)