v0.17.0 · Apache-2.0 · Local-first

The career layer that lives inside your coding agent.

Valor is a set of skills, agents, and rules that turns Claude Code, Codex CLI, and Cursor into a career coach. It runs alongside your daily work — capturing evidence and coaching at next-level — without another tool to open.

Get started Star on GitHub
  • 0runtime deps
  • 3agents supported
  • 100%local data

One-time setup

curl -fsSL https://raw.githubusercontent.com/yihanzhu/valor/main/install.sh | bash -s -- --clone

Setup

Install once. Then talk to your agent like normal.

The installer drops Valor's skills, agents, and rules into ~/.claude/, ~/.codex/, and ~/.cursor/. After that, the install command isn't part of your day — your AI agent is.

curl -fsSL https://raw.githubusercontent.com/yihanzhu/valor/main/install.sh | bash -s -- --clone
  • Read first The bootstrap is fetched from main. It's a short shell script — read it before piping to bash: curl -fsSL …/main/install.sh | less.
  • Per host Only need one agent? Pass --target claude-code, codex, or cursor.
  • Updates Checks for new releases (tagged vX.Y.Z, never main) when you start a session and notifies you when one is available — updating is manual. Pin a version with git -C ~/.valor/repo checkout vX.Y.Z.
  • Local state Career framework, evidence, and carry-forward notes live in ~/.valor/. Nothing leaves your machine.

Features

Just talk to your agent. Valor knows what you mean.

Ten on-demand workflows plus ambient coaching, triggered by natural language. It fits your day to your real calendar gaps, verifies carried-forward work before re-raising it, focuses on the project whose sync is next, and at review time assembles a self-reflection from your evidence — flagging what to confirm instead of overclaiming. All against a local evidence store. No dashboards, no telemetry.

Morning

Start the day with priorities, not inbox.

Say "start my day" and Valor pulls open Jira tickets, your PR queue, today's calendar, and yesterday's carry-forward — then proposes a focus order grounded in your target-level competencies, and fits it to your calendar's real gaps (deep vs fragmented), optionally written back as private calendar blocks on clean clock times. If you rotate between projects, it plans around the one that's due and quietly hides the rest.

See the spec
claude code
You start my day
Valor

Tickets (Jira)

  • ● AUTH-412 Retry storm under load — In Progress
  • ● AUTH-418 Session cache invalidation — In Review

Pull requests

  • #418 auth: retry policy with jittered backoff
  • #421 deps: bump httpx 0.27 → 0.28

Coaching nudge

Add a one-line rollback note to #418. That's the L5 coordination signal your framework weights most this quarter.

Day plan

  • 09:00–10:30 AUTH-412 retry fix · deep block
  • 13:30–14:00 review #421 · fragmented

In flow

Senior-level review, before you hit "Request changes".

Ask your agent to "help me review PR #418" and Valor walks architecture, blast radius, test gaps, and tone of the review itself. Say "design doc for PROJ-123" and you get the same for design — options, trade-offs, and what to explicitly punt.

PR review playbook
cursor · valor
You help me review PR #418
Valor

Architecture

Retry policy lives in the wrong layer. Move from api.client → net.transport. Future RPCs will need it too.

Test gaps

  • ! No coverage for jitter bounds.
  • ! Backoff cap untested above 30s.

Tone check

Comment on line 84 reads sharper than intended — soften to a question.

✓ Logged as evidence · code_review · subject_matter

Wrap-up

End the day with carry-forward, not loose ends.

Say "wrap up" or "call it a day" and Valor reads the day's conversation, git history, and evidence — then writes a handoff file you (or tomorrow-you) can pick up cold, verifying each carried-forward item against its source first so nothing rides on a stale guess. It also pulls notes from today's meetings — straight from your calendar events' attachments — into your local evidence store, so 1:1 prep and weekly reflection can use what actually happened.

Wrap-up spec
codex cli · valor
You wrap up
Valor

Shipped today

  • ✓ Merged #421 (httpx bump, 2 reviews)
  • ✓ Drafted rollback note on #418
  • ✓ 1:1 with E. — confirmed L5 target

Carry forward → tomorrow

  • → Land #418 before standup
  • → Reply to AUTH-412 thread (Sami)

Reflection

Strong execution day. Light on the cross-team alignment axis — flag for Friday's weekly.

✓ Saved to ~/.valor/carry-forward/carry-forward-2026-05-16.md

Review time

Turn a half-year of evidence into a review draft you can defend.

Say "half-year reflection" and Valor pulls the cycle's evidence, cross-checks git and past sessions for work you forgot to log, and clusters it into impact themes mapped to your competencies and company values. It phrases every claim from the recorded status and role — nothing reads as "shipped" unless it was — and hands you a confirm-before-you-submit list instead of overclaiming. Say "feedback about my manager" for the upward-feedback half, grounded in your 1:1 and meeting notes.

Reflection spec
claude code · valor
You half-year reflection
Valor

Impact themes

  • Auth reliability — retry + session-cache fixes. subject_matter · Ownership
  • Dependency migration — drove the httpx cutover. collaboration · led

Confirm before you submit

  • ? Is the retry fix live, or still rolling out? (status: merged)
  • ? Did you lead the migration or co-build it? (role: unset)

✓ Built from your evidence log · plain-text, paste-ready

Workflow

Install → setup → use. That's it.

  1. 01

    Install once

    Drops the skills, agents, and rules into each AI agent's config directory.

    curl -fsSL …install.sh | bash -s -- --clone

  2. 02

    Configure in your agent

    Say "set up valor". Paste your career ladder. Pick your level. Done.

    set up valor

    guided framework, level & integrations

  3. 03

    Use it as you work

    Talk to your agent like normal. Ambient coaching runs alongside.

    start my day wrap up prep for 1:1

Compatibility

Three hosts. Every major platform.

Hosts

Claude Code Codex CLI Cursor

Operating systems

macOS Linux Windows · WSL

Runtime

Python 3.9+ stdlib only no cloud

Open source

Inspect every file. Fork if you want.

Apache-2.0. Plain Python and Markdown. Local state stays on your machine, by design — see PRIVACY.md for the exact trust boundary.

★ —

stars

—

contributors

—

open issues

Apache 2.0

license

Turn your AI agent into a career coach.

One install, then you can forget it ever happened. Talk to your agent like normal.

curl -fsSL https://raw.githubusercontent.com/yihanzhu/valor/main/install.sh | bash -s -- --clone
Read the docs GitHub