Home

Conscience

A CLI tool for evaluating the impact of AI-assisted work — measuring not just velocity and output, but whether AI is serving human flourishing.

Conscience asks the question posed by Pope Leo XIV in Magnifica Humanitas: "Does AI make human life on earth 'more human' in every aspect of that life?"

Install

# macOS / Linux via Homebrew
brew tap subversivesoftwareorg/tap
brew install conscience

# From crates.io
cargo install conscience

# Prebuilt binaries
# https://github.com/subversivesoftwareorg/conscience/releases

Simplest possible start

brew tap subversivesoftwareorg/tap
brew install conscience
conscience report energy --all

That's every Claude Code and Codex session on this machine from the last 30 days, as energy, CO2, water, and everyday comparisons. No configuration, no login. See Simplest Possible Start for what you'll see and the next two steps.

First Steps

# See what's configured and what needs setting up
conscience setup

# Run your first ethical analysis
conscience examine --project .

See the Getting Started guide for a complete walkthrough.

The eight commands

Command	What it does
conscience setup	Show what's configured and how to fix what isn't
conscience examine	Ethical analysis of the current project. --pr for one pull request, --all for every project on this machine. Writes a snapshot.
conscience report <topic>	Diagnostic views: github, ai, energy, tokens, authorship, attention, history, automation
conscience reflect	Reflection questions for a team retrospective; -i --save to answer and keep them
conscience retro	Aggregate saved reflection sessions into a team view
conscience push	Send a saved snapshot to a dashboard, after you've looked at it
conscience prune <id>	Remove the launcher behind an entry from report automation: a cron line, a launchd agent, a daemon job. Never touches logs
conscience du	What conscience wrote versus the logs it only reads; --tidy removes old snapshots while keeping what history compares

The current directory is the project unless you say otherwise. Every run prints what it covered. See the Command Reference for flags.

Documentation

I want to...	Go to...
See what AI has cost, in three commands	Simplest Possible Start
Set up conscience for the first time	Getting Started
Run a team retrospective	Running a Team Retrospective
Evaluate a pull request	Evaluating a Pull Request
Understand my attention patterns	Understanding Your Attention Patterns
Measure energy consumption	Measuring Energy Cost
Set up CI/CD analysis	Setting Up CI-CD
Push results to a dashboard	Tracking Trends with a Dashboard
Look up a specific command	Command Reference
Configure conscience.yaml and thresholds	Configuration
Understand the ethical framework	The Seven Principles
Understand security signal detection	Security Signals