DevIntern

Get up and running with @devintern/code in minutes

Quick Start

@devintern/code is your AI intern for automatically implementing tasks from Jira. It fetches task details, creates feature branches, runs your AI agent, commits changes, and optionally creates pull requests — all from a single command.

Prerequisites

  • Bun runtime — Required to run @devintern/code
  • Jira account with API access
  • AI agent CLI installed (e.g., Claude Code, Opencode, Codex, Cursor)
  • Git repository for your project

Installation

Install globally with Bun:

# Install Bun if not already installed
curl -fsSL https://bun.sh/install | bash

# Install @devintern/code globally
bun install -g @devintern/code

Initialize Configuration

Navigate to your project directory and run:

devintern init

This will:

  • Create a .devintern-code folder in your current project
  • Copy .env.sample to .devintern-code/.env
  • Create settings.json for per-project configuration
  • Automatically add .devintern-code/.env to your .gitignore (to prevent leaking credentials)

After running init:

  1. Edit .devintern-code/.env with your Jira credentials
  2. (Optional) Edit .devintern-code/settings.json to configure PR status transitions

First Run

Run devintern with a Jira task key:

devintern PROJ-123

This will:

  1. Fetch Jira task details (description, comments, attachments)
  2. Transition the task to “In Progress”
  3. Create a feature branch (feature/proj-123)
  4. Run a clarity check (skippable with --skip-clarity-check)
  5. Execute your AI agent with formatted task context
  6. Commit changes automatically after successful implementation
  7. Post a summary back to Jira

What’s Next?