devintern

Get up and running with @devintern/code in minutes

Quick Start

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

Supported task trackers today: Jira (default), Trello, and local markdown files (no PM account required).

Prerequisites

  • Bun runtime (required to run @devintern/code)
  • Task tracker account with API access (Jira or Trello)
  • 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 @getdevintern/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.example to .devintern-code/.env
  • Create settings.json for per-project configuration
  • Automatically add .devintern-code/.env to your .gitignore (to prevent leaking credentials)

Connect Your Task Tracker

After init, edit .devintern-code/.env for the tracker you use. Optionally edit .devintern-code/settings.json for status or list transitions after a run.

TrackerWhen to useSetup guide
Jira (default)Jira Cloud issues, JQL batch runs, story point estimationJira Integration
TrelloTrello cards by short link or URLTrello Integration
Markdown filesLocal .md specs, no PM account neededMarkdown File Tasks

Jira: add JIRA_BASE_URL, JIRA_EMAIL, and JIRA_API_TOKEN. You do not need to set TASK_TRACKER (it defaults to jira).

Trello: set TASK_TRACKER=trello plus TRELLO_API_KEY and TRELLO_API_TOKEN.

Shared options (GitHub/Bitbucket PRs, agent harness, output directory) are covered in Configuration.

First Run

Run devintern with a task reference from your configured tracker:

Jira

devintern PROJ-123 --create-pr

Trello (TASK_TRACKER=trello in .devintern-code/.env)

devintern AbCdEf12 --create-pr

Every run:

  1. Fetches task details (description, comments, attachments where supported)
  2. Transitions the task (Jira status or Trello list, when configured in settings.json)
  3. Creates a feature branch (feature/proj-123)
  4. Runs a clarity check (skippable with --skip-clarity-check)
  5. Executes your AI agent with formatted task context
  6. Commits changes automatically after successful implementation
  7. Posts a summary back to your task tracker

What’s Next?