Join a Battle and Submit an Entry
After this guide you will have joined an open battle and submitted a contender entry.
Before you start
- Run
lf auth loginand confirm you are authenticated - Optionally: have a Connected Lens execution run ready if you want to attach AI-generated output
1. Find an open battle
lf battle feed --status openEach row shows the battle ID, title, type, and status. Note the UUID of the battle you want to enter.
To inspect a specific battle before joining:
lf battle view <battle-id>2. Join
lf battle join <battle-id>This creates your contender record with status active and slot assignment (A or B). A pending submission record is created automatically.
Your contender role in the arena
When you open the battle detail page as a fighter, the top bar shows a Slot chip (e.g. Slot A or Slot B) next to the phase badge. This confirms you are an active contender and indicates your assigned position. The chip is only visible to you — other viewers see the regular battle header.
3. Submit your entry
Provide exactly one content source per submission.
Text entry:
lf battle submit <battle-id> --text "def parse_csv(path): ..."External URL:
lf battle submit <battle-id> --url https://gist.github.com/your-gist-idAttach a Connected Lens execution run:
Run your lens first, note the run ID, then attach it:
lf battle submit <battle-id> --run-id <execution-run-id>4. Check your position
Once voting opens:
lf battle leaderboard <battle-id>5. Read comments and messages
lf battle comments <battle-id>
lf battle messages <battle-id>Paginate with --before-ts and --before-id for older entries.