@elmiristic/agent-ready 0.1.2 → 0.1.4

package/README.md

@@ -2,39 +2,62 @@
 
 Wire an AI coding agent into any GitHub repo in 5 minutes.
 
-Tag a Trello card **agent-ready**, and Claude reads the task, edits the code, opens a PR, and pings you on Telegram - twice a day, automatically.
+Tag a Trello card **agent-ready** and Claude reads the task, writes the code, opens a PR, and pings you on Telegram. Runs on your schedule, in your timezone.
 
 ## Quick start
 
 ```bash
-npx agent-ready init
+npx @elmiristic/agent-ready init
 ```
 
-The wizard will:
-1. Connect your Trello board
-2. Add your Anthropic API key
-3. Give you a Telegram chat ID via @agent_ready_bot
-4. Set all GitHub secrets automatically
-5. Write the GitHub Actions workflows into your repo
+That's it. The wizard handles everything.
 
-Then commit and push `.github/` and you're live.
+## What the wizard sets up
+
+1. **Board** - connect your Trello board and pick the right lists
+2. **Anthropic** - add your Claude API key
+3. **Telegram** - message [@agentreadybot](https://t.me/agentreadybot) and paste your chat ID. No bot setup needed.
+4. **Schedule** - pick your timezone and the times you want the agent to run each day
+5. **GitHub secrets** - set automatically via GitHub CLI, or manually if you prefer
+6. **Workflow files** - written directly into your repo under `.github/`
+
+Then run:
+
+```bash
+git add .github && git commit -m "feat: add agent-ready" && git push
+```
 
 ## How it works
 
-1. Add the `agent-ready` label to a Trello card in your **To Do** list
-2. The agent runs at **9am and 5pm** (or trigger manually in GitHub Actions)
-3. Claude reads the card title + description, identifies relevant files, writes the code
-4. A PR is opened - nothing touches `main` without your review
+1. Add the `agent-ready` label to a Trello card in your To Do list
+2. The agent runs at the times you chose during setup
+3. Claude reads the card title and description, finds the relevant files, and writes the code
+4. A PR is opened with a summary of the change
 5. You get a Telegram message with the PR link
-6. Merge the PR → card moves to **Done** automatically
+6. Merge the PR and the card moves to Done automatically
+
+Nothing touches `main` without your review.
+
+## Schedule
+
+During setup you pick your timezone and up to two daily run times. The wizard converts them to UTC and writes the correct cron expressions into your workflow file. You can also trigger a run manually anytime from the GitHub Actions tab.
 
 ## Requirements
 
 - Node.js 18+
 - A GitHub repository
-- GitHub CLI (`gh`) for automatic secret setup (optional - can set manually)
 - A Trello account
-- An Anthropic API key
+- An Anthropic API key (get one at [console.anthropic.com](https://console.anthropic.com))
+- GitHub CLI (`gh`) for automatic secret setup — optional, secrets can be added manually
+
+## Supported board tools
+
+| Tool | Status |
+|------|--------|
+| Trello | Available |
+| Jira | Coming soon |
+| Linear | Coming soon |
+| GitHub Projects | Coming soon |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elmiristic/agent-ready",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Wire a Trello + Claude AI + GitHub Actions coding agent into any repo in 5 minutes.",
   "type": "module",
   "bin": {

package/src/init.js

@@ -4,6 +4,7 @@ import { selectProvider } from './steps/selectProvider.js'
 import { collectTrello } from './steps/collectTrello.js'
 import { collectAnthropic } from './steps/collectAnthropic.js'
 import { collectTelegram } from './steps/collectTelegram.js'
+import { collectSchedule } from './steps/collectSchedule.js'
 import { setGithubSecrets } from './steps/setGithubSecrets.js'
 import { scaffold } from './steps/scaffold.js'
 import { done } from './steps/done.js'
@@ -15,9 +16,10 @@ export async function init() {
     const board = await collectTrello()
     const anthropic = await collectAnthropic()
     const telegram = await collectTelegram()
+    const schedule = await collectSchedule()
     const secrets = { ...board, ...anthropic, ...telegram }
     await setGithubSecrets(secrets)
-    await scaffold()
+    await scaffold({ crons: schedule.crons })
     await done()
   } catch (err) {
     if (err.name === 'ExitPromptError') {

package/src/steps/collectSchedule.js

@@ -0,0 +1,85 @@
+import chalk from 'chalk'
+import { select, confirm, input } from '@inquirer/prompts'
+
+const TIMEZONES = [
+  { name: 'UTC+0  — London, Lisbon', value: 0 },
+  { name: 'UTC-5  — New York, Toronto', value: -5 },
+  { name: 'UTC-6  — Chicago, Mexico City', value: -6 },
+  { name: 'UTC-7  — Denver, Phoenix', value: -7 },
+  { name: 'UTC-8  — Los Angeles, Vancouver', value: -8 },
+  { name: 'UTC+1  — Paris, Berlin, Rome', value: 1 },
+  { name: 'UTC+2  — Cairo, Kyiv, Helsinki', value: 2 },
+  { name: 'UTC+3  — Istanbul, Moscow, Riyadh', value: 3 },
+  { name: 'UTC+4  — Dubai, Baku', value: 4 },
+  { name: 'UTC+5  — Karachi, Tashkent', value: 5 },
+  { name: 'UTC+5:30 — Mumbai, Kolkata', value: 5.5 },
+  { name: 'UTC+6  — Dhaka, Almaty', value: 6 },
+  { name: 'UTC+7  — Bangkok, Jakarta', value: 7 },
+  { name: 'UTC+8  — Singapore, Beijing, Perth', value: 8 },
+  { name: 'UTC+9  — Tokyo, Seoul', value: 9 },
+  { name: 'UTC+10 — Sydney, Melbourne', value: 10 },
+  { name: 'UTC+12 — Auckland', value: 12 },
+]
+
+function toUtcHour(localHour, offsetHours) {
+  const utc = ((localHour - offsetHours) % 24 + 24) % 24
+  return Math.round(utc)
+}
+
+async function askHour(label) {
+  const raw = await input({
+    message: `  ${label} (0-23, e.g. 9 for 9am)`,
+    validate: (v) => {
+      const n = Number(v)
+      if (isNaN(n) || n < 0 || n > 23) return 'Enter a number between 0 and 23'
+      return true
+    },
+  })
+  return Number(raw)
+}
+
+export async function collectSchedule() {
+  console.log(chalk.bold('  Schedule'))
+  console.log()
+  console.log(chalk.dim('  Choose when the agent checks for tasks each day.'))
+  console.log()
+
+  const offset = await select({
+    message: '  Your timezone',
+    choices: TIMEZONES,
+    pageSize: 10,
+  })
+
+  console.log()
+
+  const hour1 = await askHour('First run time')
+  const utc1 = toUtcHour(hour1, offset)
+
+  console.log()
+
+  const addSecond = await confirm({
+    message: '  Add a second daily run?',
+    default: true,
+  })
+
+  console.log()
+
+  const crons = [`0 ${utc1} * * *`]
+
+  if (addSecond) {
+    const hour2 = await askHour('Second run time')
+    const utc2 = toUtcHour(hour2, offset)
+    crons.push(`0 ${utc2} * * *`)
+    console.log()
+  }
+
+  const fmt = (h) => `${h % 12 === 0 ? 12 : h % 12}${h < 12 ? 'am' : 'pm'}`
+  const times = addSecond
+    ? `${fmt(hour1)} and ${fmt(Number(crons[1].split(' ')[1]) + offset)}`
+    : fmt(hour1)
+
+  console.log(chalk.dim(`  Agent will run at ${times} your time.`))
+  console.log()
+
+  return { crons }
+}

package/src/steps/scaffold.js

@@ -6,7 +6,7 @@ import { workflowTemplate } from '../templates/workflow.js'
 import { agentScriptTemplate } from '../templates/agentScript.js'
 import { doneWorkflowTemplate } from '../templates/doneWorkflow.js'
 
-export async function scaffold() {
+export async function scaffold({ crons } = {}) {
   const spinner = ora({ text: '  Generating workflow files...', indent: 2 }).start()
 
   const cwd = process.cwd()
@@ -19,7 +19,7 @@ export async function scaffold() {
 
   await fs.writeFile(
     path.join(workflowsDir, 'agent-ready.yml'),
-    workflowTemplate(),
+    workflowTemplate(crons),
   )
 
   await fs.writeFile(

package/src/templates/workflow.js

@@ -1,10 +1,10 @@
-export function workflowTemplate() {
+export function workflowTemplate(crons = ['0 9 * * *', '0 17 * * *']) {
+  const cronLines = crons.map(c => `    - cron: '${c}'`).join('\n')
   return `name: agent-ready
 
 on:
   schedule:
-    - cron: '0 9 * * *'
-    - cron: '0 17 * * *'
+${cronLines}
   workflow_dispatch:
 
 permissions: