Visual Guide

Use the AOC CLI without leaving Git.

The CLI is a command layer over your existing Git repository. Git still performs the version-control work; AOC adds identity, project context, task state, and contribution records.

Authenticate

Approve the device in your browser and keep tokens outside the repository.

aoc login

Link Project

Attach the current Git repository to its Attack on Code project context.

aoc project link

Pick Task

View assigned work and mark the task you are actively building.

aoc task start AOC-184

Ship Work

Commit and push through Git while AOC records contribution metadata.

aoc commit && aoc push

First linked task

$ aoc login
$ aoc clone examforge
$ cd examforge
$ aoc project link
$ aoc task start AOC-184

✓ Logged in as Nayant Srivastava
✓ Repository linked to ExamForge
✓ Active task set to AOC-184

What gets stored

Global config~/.aoc/config.json

API URL, web URL, default remote

Repo config.aoc/config.json

Project slug, team, active task

Local queue.aoc/cache/pending-events.json

Offline contribution events

Daily Loop

aoc status

aoc pull --rebase

aoc task list

aoc task submit AOC-184

Git Layer

aoc add .

aoc commit -m "Implement task"

aoc push

aoc branch create feature/AOC-184

Recovery

aoc doctor

aoc auth status

aoc contribution sync

aoc project info

Commit with task context

Contribution registration

$ aoc add .
$ aoc commit -m "Implement OAuth callback validation"
$ aoc push
$ aoc task submit AOC-184

✓ Commit created: 52bd83a
✓ Linked to task AOC-184
✓ Contribution registered with Attack on Code

What `aoc status` should tell you

Project

ExamForge

Active task

AOC-184 - OAuth callback validation

Branch

feature/AOC-184-oauth-validation

Ahead / Behind

2 ahead / 0 behind

Pending sync

0 local events

If any row is missing or marked as a warning, run aoc doctor.