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

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 six 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
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

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...
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