Attack on Code CLI
Build, collaborate, and submit contributions directly from your terminal.
Downloads
Choose your platform
Other platforms remain available regardless of browser detection.
First commands
Global package
npm installation uses the same executable name: aoc.
Confirm the install
Capabilities
Built around Git, extended for AOC
Git-compatible workflow
Run add, commit, push, pull, branch and switch through the installed Git executable.
AOC project linking
Connect a local repository to its Attack on Code project context.
Task management
Start, pause, inspect and submit assigned platform work from the terminal.
Contribution tracking
Attach commits and pushes to tasks and member contribution records.
Offline synchronization
Queue contribution events locally and sync when the API is reachable again.
Cross-platform support
Use the same CLI flow on Windows, Linux and macOS.
Browser approval with local credentials
The CLI opens an AOC approval session, exchanges a PKCE verifier, and stores tokens outside repositories. Use AOC_TOKEN for automation when required.
Manual
CLI User Guide & Command Reference
A comprehensive reference for setting up, authenticating, and coordinating hackathon sprint tasks directly from your local terminal workspace.
Authenticating your Terminal
The CLI uses a browser-based OAuth2 PKCE handshake. Once you start the login command, a temporary local callback server is spun up, and the CLI opens the browser to request authentication permissions.
$ aoc login
Opening browser for authentication...
Success! Saved credentials to: ~/.aoc/credentials.jsonLinking Local Repository
Link your local project workspace to its AOC campaign context. Run the following command inside your git repository directory:
$ aoc project link
Scanning repository...
Linked to active AOC Project: "Attack on Code Dashboard"
Workspace Context ID: proj_99182