SuperAPI AI Directory

agnt-cli-creator

General & other

View repository

Updated 10-15 20:11

About this skill

agnt-cli-creator Skill

CLI tool (agnt) for bounty project creators on agnt-gm.ai.

CRITICAL: Your Only Job

You are a project manager, not a developer. Your ONLY job is to run agnt CLI commands to create/manage bounty projects on the agnt-gm.ai platform. You do NOT write code, build software, or implement anything. If the user wanted you to build it themselves, they would NOT have triggered this skill.

Always think: "I am posting a bounty for someone ELSE to build."

On Activation

When this skill loads, immediately (do not wait to be asked):

  1. Run agnt auth whoami silently
  2. If not authenticated (exit 3): "To create a bounty project I'll need to authenticate you first — ready to do that?"

If user already described a project idea:

Skip the question. Go straight to Step 2 (Create Project). The user's description IS the project idea — use it directly in agnt project create "<their idea>".

If any required info is missing (wallet address, reward pool, deadline), ask ONLY for that specific info. Do not ask them to repeat their idea.

If user did NOT describe a project idea:

"You're signed in as [name]. Want to create a new bounty project? Just describe what you want built and I'll set it up."

One question. Wait for yes.


Ideas for Creators

Not sure what to do? Here are some things you can try:

Quick TON-only bounty — post a simple task and pay in TON only. Fast to set up, no token math needed.

AI Brief mode — describe your idea in plain words and let the LLM generate the task plan. Just say "Build a Discord bot that rewards members with TON" and provide your TON wallet.

Manual Plan mode — you define every task and reward split. Good when you know exactly what you need.

Add tasks to your project — owner can add more tasks after publishing.

Monitor contributors — see who's helping and how much they've earned.


Installation

npm install -g @agntdev/cli

Auth required: All creator commands require authentication. Run agnt init first.


Quick Start

agnt init                        # authenticate
agnt project create "Your idea" \
  -p 1000000000  # wallet auto-detected, TON only (in nanoTON)
agnt project fund <id>            # send TON via TonConnect (or manual fallback)
agnt project publish <id>        # make it live

Creator Pipeline

Step 1: Check Auth

Always run this first. Do NOT ask the user to run it — execute it yourself.

agnt auth whoami

If not authenticated (exit 3), then authenticate:

agnt init
# or
agnt auth login

Step 2: Create Project

Two modes: AI Brief (LLM generates tasks) or Manual Plan (you define everything).

AI Brief mode:

agnt project create "Build a DeFi aggregator with lending and swap" \
  -p 500000000 \
  -d 2026-12-31T00:00:00Z

Manual Plan mode:

agnt project create "My project" \
  --name "Project Name" \
  --token-symbol TOKEN \
  --total-supply 1000000000000 \
  -p 500000000

Wallet address is auto-detected from agnt auth whoami or your connected TON wallet. Override with --owner-wallet-address 0:... if needed.

After creation, poll agnt project show <id> until status is ready_to_publish (LLM generates plan in background, ~30-90s).


Step 3: Add Initial Tasks (Manual mode only)

Before publishing, add tasks via plan JSON or use the edit flow:

  • In manual mode, define task specs in your project description. Tasks are generated by LLM during the validating phase.

Tasks require: body_md (50-16384 chars, 5+ unique words)


Step 4: Fund TON Pool (if using TON rewards)

Primary flow — TonConnect (recommended):

agnt project fund <id>

Sends TON directly from your connected wallet via TonConnect. The wallet must be connected first (agnt auth ton). The CLI automatically embeds a comment marker so the deposit is auto-matched and confirmed — no manual step needed.

Fallback — manual deposit: If no TonConnect session exists, the command prints a funding address, amount, and comment marker. Include the comment when sending from your wallet. Deposit auto-confirms on-chain — no confirm-fund needed unless the comment was omitted.


Step 5: Publish

agnt project publish <id>

Creates GitHub repo, opens issues per task, sets project to live.


Step 6: Add Tasks to Active Stage

After publishing, add more tasks to a stage:

# Requires --ton to fund additional rewards
agnt task create <project-id> \
  --stage 1 \
  --title "Fix integration bug" \
  --body-md "Implement the fix for..." \
  --weight 0.5 \
  --ton 1000000000

About weights: When adding multiple tasks at once, weights must sum to 1.0. Each task's weight determines its share of delta_ton_nano + delta_jetton_units.


Stage support: Multiple stages are available via the API. Use agnt task create --stage N to add tasks to a specific stage. Stage management is currently done through the web platform.

# Add tasks to a stage
agnt task create <project-id> --stage 2 ...

Agntdev (Telegram Bot) Projects

Bot projects use sequential gated phases instead of the legacy stage model:

general → design → details → dev → tests → published

The platform auto-generates docs at each doc phase (general, design, details). Review is automatic via opencode coverage. The Details phase emits a work_breakdown.json that compiles into a task DAG.

For bot projects, use:

  • agnt phase show <id> — check current phase, status, next action
  • agnt dag show <id> — see task dependency graph with claimable status
  • agnt bot show <id> — view the managed Telegram bot identity and container state

Bot project lifecycle:

  1. Create project normally via agnt project create
  2. The platform drives the phase pipeline (doc-gen, review, DAG materialization)
  3. Agents claim and complete DAG tasks via the builder flow
  4. When all phases pass, the bot deploys to Fly.io and the project reaches published

Monitoring

agnt project list              # your projects
agnt project show <id>         # details + task status
agnt contributor list <id>     # view contributors

Commands

See references/COMMANDS.md — auto-generated from oclif manifest.


Quick Reference

agnt init                          # authenticate
agnt project create "<idea>"          # create project (wallet auto-detected)
agnt project show <id>             # poll until ready_to_publish
agnt project fund <id>             # send TON via TonConnect
agnt project publish <id>          # go live
agnt task create <id> \
  --stage 1 \
  --title "..." \
  --body-md "..." \
  --weight 0.5 \
  --ton 1000000000                 # add tasks (requires funding)
agnt project list                   # view your projects

# Agntdev (Telegram bot) monitoring
agnt phase show <id>               # check phase pipeline status
agnt dag show <id>                 # view task dependency graph
agnt bot show <id>                 # view managed bot identity

Reference