Start here · 5 min
Get useful context in five minutes
Install Brief, sign in to your team, and let your coding agent find the right code and rules.Last updated August 2026Copy a starter prompt ↓
1. Install Brief in your coding agent
Run setup from a repository in your terminal, or ask Codex or Claude Code to run it for you. Brief detects the invoking agent; from a normal terminal it lets you choose every detected agent you want to configure.
Recommended
npx -y runbrief@stable setup
Choose both explicitly
npx -y runbrief@stable setup --agent codex --agent claude
2. Approve the browser request
- Sign in, or create a Brief account if you do not have one.
- Choose the workspace and data-sharing mode for this environment.
- Select Connect, then return to the terminal.
- Restart or reopen each configured coding agent in the repository.
Ask your coding agent
Can you use Brief to check that I'm signed into the right team and connected to this repo? Make sure the team's approved rules and skills are available. Don't change anything yet.
Brief should confirm the repo, team, and connector. Your source stays local by default; the team receives derived context and proof, not a silent copy of the codebase.
3. Confirm Brief is automatic
Ask your coding agent
Check the Brief default instruction for this coding agent without changing repository files. Confirm that meaningful work starts with brief.install_status, follows the returned context route, and ends with diff review. Never print, move, or commit the local credential.
4. Ask one small, real question
Ask your coding agent
Before we change anything, use Brief to inspect <component, bug, or feature>. Show me the few files that matter, the rules that apply, the closest reusable pattern, and the best focused test. Cite your sources.
A good first answer is small: a few source files, one reuse opportunity, one risk, and one focused next step.
Was this guide useful?Help us make Brief easier to learn.
Ready for another workflow?Choose your next mission →