All notable changes to certwiz will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.4.2 - 2026-09-09
- Help text clarifications: SAN prefixes per command, the default output directory on
ca,csr, andsign, bundle behaviour forconvert, the concurrent probe and retry intls, and the Windows limitation onupdate - README and docs rewritten for 0.4.x: working install commands, correct release asset names, every command documented, emojis removed
0.4.1 - 2026-09-09
cert inspectreports a missing file for path-like targets (a directory separator, a leading.or~, or a certificate extension such as.pem) instead of trying to connect to them as hostnames
- CI workflows use Node 24 versions of every GitHub Action; GoReleaser is pinned to v2
0.4.0 - 2026-09-09
cert converthandles certificate bundles: PEM output keeps every certificate, DER output reports a clear error when the input holds more than onecert signaccepts EC CA keys and DER-encoded CA certificatescert csrreports ECDSA public keys correctly- Email and URI SANs are shown in the terminal view, matching the JSON output
- Extensive test coverage (about 95% of statements), including in-process TLS servers for remote inspection and
cert tls
cert tlsprobes all TLS versions concurrently, with a sequential retry for versions that fail while the host is reachable; a down host now fails in one timeout instead of four- Errors are printed to stderr exactly once; JSON error payloads stay on stdout
--timeoutoninspectandtlsis a proper duration flag (e.g.2s,500ms)cert updatedownloads the installer to a private temp file with a 30s HTTP timeout and removes it after running- Terminal key-usage labels now use the same wording as the JSON output (e.g. "Server Authentication")
- Terminal width is read from stdout, so piped stdin no longer forces the 80-column fallback
- Non-JSON errors from
ca,csr, andsignare now shown in the terminal (previously only cobra's line was printed)
- Private keys are created with 0600 permissions directly instead of 0644 then chmod;
cert csrkeys were previously left at 0644 - Wrapped fingerprint and SAN lines were misaligned by one column
cert signreported the wrong parse error when a CA key was not PKCS#8- Files whose name starts with "http" were treated as URLs in the inspect title
- Stale
go.mod.ci,test-ci.sh, and the Makefiletest-citarget
0.3.0 - 2026-07-07
- SHA-256 and SHA-1 fingerprints in
cert inspectoutput and JSON (fingerprint_sha256,fingerprint_sha1) --keyflag forcert verifyto check that a private key matches a certificate (PKCS#8, PKCS#1, and EC keys supported); JSON output includeskey_matches--expires-inflag forcert verifyto fail (exit 1) when a certificate expires within a window (e.g.30d,720h) - useful for CI and cron monitoring- Certificate bundle support in
cert inspect: files with multiple certificates (e.g.fullchain.pem) are no longer silently truncated to the first certificate; use--chainto display all of them - stdin support in
cert inspect:cert inspect -reads a certificate from stdin (e.g. piped fromopenssl s_client) --jsonoutput support for theca,csr,sign, andconvertcommands- Success output uses the standard operation result format (
success,message,files) - Errors are emitted as JSON payloads when
--jsonis set
- Success output uses the standard operation result format (
cert tlsnow works with URLs (cert tls https://example.com) and hostnames starting with "http" (e.g.httpbin.org:8443)- Generated certificates (
generate,ca) now use random serial numbers instead of a fixed serial of 1, avoiding RFC 5280 violations and browser errors when regenerating certificates cert updatenow aborts if the installer download returns a non-200 HTTP status instead of executing the error page--sanIP prefix is now case-insensitive (ip:10.0.0.1no longer becomes a DNS name)- Invalid
--timeoutvalues now produce an error instead of being silently ignored - URI SANs in CSRs are now shown by
ParseCSRand routed tourisin JSON output - IPv6 addresses are now handled correctly when building dial addresses
0.2.4 - 2026-01-23
- Cipher suite information displayed for URL inspections
- New "TLS Version" and "Cipher Suite" fields in
cert inspectoutput - Shows negotiated cipher suite for each TLS version in
cert tlscommand - JSON output includes
tls_versionandcipher_suitefields - Only shown for URL inspections (not file-based inspection)
- New "TLS Version" and "Cipher Suite" fields in
0.2.3 - 2026-01-13
- Plain output mode with
--plainflag- Disables borders, colors, and emojis for easy copy/paste
- Works with all commands
- Config file support
- Locations:
~/.config/certwiz/config.yamlor~/.certwiz.yaml - Configure default output preferences (borders, colors, emojis)
- Priority:
--plainflag > config file > CI detection > defaults
- Locations:
- Added configuration section to README
- Documented config file format and locations
0.2.2 - 2026-01-13
- New
cert tlscommand for TLS version testing- Tests which TLS versions a server supports (1.0, 1.1, 1.2, 1.3)
- Shows supported versions with color-coded status
- Includes
--jsonoutput for automation - Supports
--timeoutflag for connection timeout
0.2.1 - 2025-09-02
- Signature algorithm selection for
inspectcommand- New
--sig-algflag to force ECDSA or RSA certificate selection - Supports values:
auto(default),ecdsa,rsa - Works by controlling cipher suite advertisement in TLS ClientHello
- Useful for testing servers with dual-certificate configurations
- Only affects TLS 1.2 and below (TLS 1.3 handles signatures differently)
- New
- Added examples for
--sig-algflag usage - Updated command reference with new flag details
- Added explanation of signature algorithm selection mechanism
0.2.0 - 2025-09-02
- Centralized environment helpers (
internal/environ)IsCI()for detecting CI environmentsSupportsUnicode()for terminal capability detection
- CA chain verification in
verifycommand- New
--caflag accepts PEM or DER format CA certificates - Full chain validation using
x509.VerifyOptions
- New
- Network timeout for
inspectcommand- Default 5-second connection timeout to prevent hangs
- New
--timeoutflag for custom timeout values
- DRY SAN parsing via
pkg/cert/san.g 8000 o- Supports DNS, IP, email, and URI SANs
- Consistent parsing across generate, CSR, and CA commands
- Secure key permissions: Generated private keys now have
0600permissions on Unix - Standardized JSON output with unified
printJSONandprintJSONErrorhelpers - Consistent error handling: All commands now use
RunEwith proper error returns - Improved code organization: Reduced duplication across commands
- Enhanced documentation: Updated commands.md, usage.md, and FAQ
- Private keys are now created with restrictive permissions (0600) by default
- Proper CA certificate validation in verify command
0.1.10 - 2025-08-20
- Critical fix for
cert updatecommand- Fixed syscall.Exec argument issue that caused installer to drop to shell
- Properly pass "bash" as argv[0] for syscall.Exec
- Update command now correctly executes the installer script
0.1.9 - 2025-08-20
- New
--connectflag for inspect command- Allows connecting to a different host while validating the certificate for the target hostname
- Useful for testing certificates through proxies, tunnels, or local services
- Supports port specification in the connect host (e.g.,
--connect localhost:8080) - Example:
cert inspect api.example.com --connect localhost:8080
- Enhanced inspect command to support split hostname/connection scenarios
- Improved examples in help text to show proxy/tunnel use cases
0.1.8 - 2025-08-20
- Critical fix for macOS auto-update functionality
- Fixed SIGKILL issue when running
cert updateon macOS - Installer now uses atomic move operations for self-updates
- Update command uses syscall.Exec to break process inheritance chain
- Clears macOS extended attributes (com.apple.provenance) that prevent execution
- Fixed SIGKILL issue when running
- Improved update reliability
- Downloads installer to temp file instead of piping directly
- Better handling of running binary replacement
- Fallback mechanisms for compatibility
- Removed duplicate release workflow (now using only goreleaser)
- Enhanced installer script with self-update detection
- Simplified default command output (run without arguments) - examples now only shown with
cert help
0.1.7 - 2025-08-20
- Fixed goreleaser configuration for v2 compatibility
- Added version: 2 declaration to .goreleaser.yml
- Updated release and brews sections for v2 format
This is a hotfix release to address the goreleaser build issue in v0.1.6. All features from v0.1.6 are included in this release.
0.1.6 - 2025-08-20
- PKI (Public Key Infrastructure) functionality
- New
cert cacommand to create Certificate Authority certificates - New
cert csrcommand to generate Certificate Signing Requests - New
cert signcommand to sign CSRs with a CA certificate - Complete PKI workflow support for internal certificate management
- New
- JSON output support
- Global
--jsonflag for all commands - Structured JSON output for scripting and automation
- JSON formatting for certificates, CSRs, and verification results
- Global
- Enhanced certificate display
- Added CSR information display functionality
- Improved certificate chain visualization
- Better formatting for Subject Alternative Names (SANs)
- CI/CD compatibility improvements
- Fixed Unicode character rendering issues in CI environments
- Added ASCII fallback for terminals that don't support Unicode
- Replaced emoji with ASCII equivalents in CI mode
- Cross-platform compatibility
- Fixed Windows file permission issues in tests
- Added OS-specific permission handling for private keys
- Improved path handling for Windows systems
- Test reliability
- Fixed TestCommandStructure to account for Cobra auto-generated commands
- Added missing newlines in generated files for Go compatibility
- Improved test coverage for new PKI features
- Updated version to 0.1.6
- Improved code formatting with gofmt
- Enhanced error messages for better user experience
0.1.5 - 2025-08-19
- Self-update functionality with
cert updatecommand - Version checking and automatic update notifications
- Various bug fixes and improvements
0.1.4 - 2025-08-19
- Installer script improvements
- Binary detection enhancements
0.1.3 - 2025-08-19
- Windows test path problems
- Cross-platform compatibility improvements
0.1.2 - 2025-08-19
- Improved installer script
- Better binary management
- Installation issues on various platforms
0.1.1 - 2024-08-19
- Minor bug fixes and improvements
- Documentation updates
0.1.0 - 2024-08-19
- Initial release of certwiz
cert inspectcommand for viewing certificates from files or URLscert generatecommand for creating self-signed certificates with SANscert convertcommand for converting between PEM and DER formatscert verifycommand for validating certificates- Beautiful terminal output with colors and formatting
- Smart text wrapping for long SANs lists
- Certificate chain viewing with
--chainflag - Detailed extension analysis with
--fullflag - Support for custom ports when inspecting remote certificates
- Automatic format detection for certificate files
- Comprehensive documentation
- CLAUDE.md for AI assistant context
- Color-coded certificate status (valid, expiring, expired)
- Human-readable certificate extension display
- Support for wildcard certificates
- IP address SANs support
- Terminal width detection for responsive output
- Cross-platform support (macOS, Linux, Windows)
- Built with Go 1.20+
- Uses Cobra for CLI framework
- Uses Lipgloss for beautiful terminal UI
- Binary named
certfor ease of use - Project name remains
certwiz