forgeScript.documentation.md

ForgeScript

A plain-text DSL for bulk task creation in WorkForge.

ForgeScript lets you create one or many tasks using a single block of text — no forms, no modals, no clicking. Write tasks like you'd jot them down in a notepad, and WorkForge parses them into fully structured entries.

---

Syntax Overview

Each line is one task. Tokens can appear in any order after the task title.

[#type] <title>
<description>
[@@reviewer]
[@assignee...]
[+tag...]
[~due]
subtask:
  - [] <subtask title>
  - [x] <subtask title>

---

Tokens

Token	Description	Example
#	Task type	#bug, #feature, #chore
@	Assignee(s)	@ujen, @sita @ram
@@	Reviewer	@@prabin
+	Tag(s)	+auth, +critical
~	Due date	~2026-06-01, ~friday, ~next-week
^	Project Slug	^workforge-core
[]	Sub task	[] sub task 1
[x]	Sub task	[] sub task completed

Subtasks are indented lines beginning with - directly under the parent task.

---

Task Types

Type	Alias
#feature
#bug
#chore
#improve
#docs
#refact
#research

The type defaults to #chore.

---

Due Date Formats

ForgeScript accepts both absolute and relative due dates.

Absolute

~2026-06-01
~06/01/2026

Relative

~today
~tomorrow
~friday
~next-week
~next-month
~eow        (end of week)
~eom        (end of month)

---

Examples

Single task

Fix login redirect loop #bug @ujen @@prabin +auth ~tomorrow ^workforge-core

---

Bulk task creation

---
#TYPE! TITLE
--
DESCRIPTION
--

@@REVIEWER
@ASSIGNEES

+TAGS

~DUE-DATE

---

#TYPE! TITLE
--
DESCRIPTION
--

@@REVIEWER
@ASSIGNEES

+TAGS

~DUE-DATE

---

---