v0.7.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
  • Per host Only need one agent? Pass --target claude-code, codex, or cursor.
  • Updates Minor and patch releases auto-apply when you start a new session. No re-install needed.
  • 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.

Eight 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, and — if you rotate projects — focuses on the one whose sync is next. 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.

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/2026-05-16.md

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