Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.formal.ai/llms.txt

Use this file to discover all available pages before exploring further.

May 23, 2026
New FeaturesImprovements

0.11.0

New
  • Add an uninstall command to completely remove Formal from the machine
  • Add an input.source field to allow policies to differentiate desktop policy enforcement from connector policy enforcement
Changed
  • Improve performance of fetching updates from the control plane
  • Improve performance of formal ls
May 21, 2026
New FeaturesImprovements

0.10.1

NewChanged
  • Change macOS CA trust dialog back to the default Security dialog
May 21, 2026
New Features

0.10.0

New
  • Add device trust support for MySQL
  • Forward MySQL policy block messages to clients
May 20, 2026
New Features

0.9.21

New
  • Support Codex block messages
  • Support HTTP header rewrites for HTTP technology
Changed
  • Decrease bundle size by 50%
  • Rename transparent proxy to transparent mode
  • Rename ca install for Linux to ca trust for macOS-Linux parity
May 19, 2026
Improvements

0.9.20

Changes
  • Only check for updates if check_for_updates is set in config.toml.
May 18, 2026
Improvements

0.9.18

Changes
  • Show a custom Formal dialog when asking the user for permission to add CAs
May 15, 2026
New Features

0.9.17

New
  • By default, block QUIC traffic when the transparent proxy is enabled. Control this via the allow_quic configuration parameter.
  • Support Claude Chat for LLM sessions when allow_quic is false.
May 12, 2026
New Features

0.9.16

New
  • Support enabling the transparent proxy on desktop app startup via config.toml
May 11, 2026
New FeaturesImprovements

0.9.15

New
  • Support auto-classification of HTTP and MCP traffic
  • Support device trust for MongoDB
Changed
  • Install the network extension as part of the installer
May 11, 2026
New Features

0.9.14

New
  • Support desktop evaluation and logging of MCP traffic
  • Support network rules that don’t require resources
Fixed
  • Indicate to users that sudo is required for formal ca trust
  • Use total input tokens instead of input tokens
  • Correct CA installation out of sync race conditions
May 7, 2026
New Features

0.9.13

New
  • Support user identity in policy evaluation
  • Support transparent proxy for Linux
May 6, 2026
Improvements

0.9.12

New
  • Support LLM header rewrites
  • Remove the --only-agents, --transparent, and --local-tls flags
May 5, 2026
Improvements

0.9.10

New
  • Support session stage evaluation for the LLM technology
May 4, 2026
Improvements

0.9.9

New
  • Support policy enforcement for the MCP technology without a connector
  • New formal transparent-proxy install and formal transparent-proxy uninstall commands
April 29, 2026
Improvements

0.9.8

Changed
  • Add Formal CA to keychain via installer
New
  • Support policy enforcement for HTTP resources without a connector
  • Support connection process and user information in network rules
April 28, 2026
Improvements

0.9.7

Changed
  • Automatically add Formal CA to Keychain when enabling the transparent proxy
April 27, 2026
Improvements

0.9.6

Changed
  • Enable the transparent proxy via the system tray.
  • Support users in network rules
April 23, 2026
Improvements

0.9.5

Changed
  • Support custom block messages for Claude Code tool calls
April 20, 2026
Improvements

0.9.4

Changed
  • Support network rules in transparent proxy
April 17, 2026
Improvements

0.9.3

Changed
  • Support policy enforcement of LLM sessions without a Connector
April 13, 2026
Improvements

0.9.2

Changed
  • Improve performance of transparent mode
April 10, 2026
New Features

0.9.0

New
  • Add support for machine user auth via AWS SigV4
April 9, 2026
New FeaturesImprovements

0.8.4

Changed
  • Improve LLM session id saving for replay

0.8.3

New
  • Support connecting to MCP resources
  • Support log encryption for LLM technology
April 7, 2026
New FeaturesImprovements

0.8.2

New
  • Separate TLS settings for LLM technology
Changed
  • Emit session events for LLM technology sessions
April 6, 2026
New Features

0.8.1

New
  • Do not require a Connector to use the LLM technology
April 2, 2026
New FeaturesImprovements

0.8.0

New
  • Support connecting with --transparent mode
  • Support connecting with --only-agents mode
  • Support connecting with --local-tls mode
  • Pass process ancestor information
  • Support LLM technology
Changed
  • Reject CLI arguments for formal-agent
March 10, 2026
New Features

0.7.3

New
  • Managed Connector SSH host keys in an isolated host keys file.
March 5, 2026
Bug Fixes

0.7.2

Fixed
  • Fixed a bug where the resource alias was used for smart routing rather than the resource name.
February 27, 2026
New FeaturesBug Fixes

0.7.1

New
  • Added support for resource aliases
  • Added a --launch argument to formal connect to launch the appropriate CLI program after connecting (for example psql or ssh).
Fixed
  • Fixed a bug where the interactive formal ls parent process didn’t exit when launching a CLI program, obscuring connection errors and policy block messages.
February 23, 2026
Improvements

0.7.0

Changed
  • Improved formal ls performance by moving search filtering server-side
  • Reduced unnecessary API calls during credential renewal
February 19, 2026
Bug Fixes

0.6.0

Fixed
  • Fixed a bug where the desktop app CLI would attempt to launch the agent when run without a TTY.
    • Note: this introduces a small breaking change where running formal without a TTY will now exit with an error and show help text. Please run formal agent instead.
February 19, 2026
Bug Fixes

0.5.7

Fixed
  • Fix smart routing for MySQL resources
January 21, 2026
Bug Fixes

0.5.6

Fixed
  • Fix a bug where the desktop app would timeout when listing resources in non-interactive mode
December 22, 2025
New Features

0.5.5

New
  • Add support for JSONL and YAML output format to formal ls
December 19, 2025
Bug Fixes

0.5.4

Fixed
  • Fix MySQL authentication with clients that send a null byte for empty passwords
December 19, 2025
Improvements

0.5.3

Changed
  • Refresh MFA challenges every second
December 17, 2025
New FeaturesBug Fixes

0.5.2

New
  • Add support for the new MySQL proxy implementation
Fixed
  • Fix DynamoDB authentication
December 11, 2025
Improvements

0.5.1

Changed
  • Improve MFA user experience
December 8, 2025
New Features

0.5.0

New
  • Add support for MFA policy enforcement
Nov 27, 2025
Improvements

0.4.4

Changed
  • It is no longer required to specify a resource name with formal disconnect. By default, it disconnects all resources.
November 24, 2025
New FeaturesImprovementsBug Fixes

0.4.3

New
  • Added support for Windows.
  • Added support for wrapping AWS S3 commands to funnel traffic through the Connector.
Changed
  • Change SSH config configuration to be compatible with SCP via the Connector.
  • Change SSH config configuration to be use resource names as SSH host names.

0.4.2

Fixed
  • Fixed a build issue where the desktop app would not provide an icon on Linux.
September 8, 2025
New FeaturesBug Fixes

0.2.7

Fixed
  • Fixed a bug that prevented the desktop app from logging out from the command line.

0.2.6

New
  • Added a -y flag to formal auth login to bypass the browser confirmation prompt.
Fixed
  • Fixed a bug where the desktop agent could be launched multiple times.
August 25, 2025
New FeaturesImprovementsBug Fixes

0.2.5

New
  • Implemented pagination of resources to reduce startup delay of formal ls.
Changed
  • Reworked connecting/disconnecting to resources to be asynchronous, which prevents a connection from blocking the TUI from rendering.
Fixed
  • Fixed a bug where the desktop app would show multiple instances of the same resource while filtering and connecting.
  • Fixed a bug where the autolaunch functionality could freeze the TUI.
August 22, 2025
New FeaturesImprovements

0.2.4

New
  • Added support for using token authentication in headless mode.
  • Introduced a configurable timeout for the formal agent command with --timeout.
Changed
  • Changed the formal ls command to lazily load resources and show a loading spinner instead of blocking the TUI from launching.
August 21, 2025
New Features

0.2.3

New
  • Added a formal agent command to launch the Formal Agent through the CLI.
  • Added a headless mode, which can be launched through formal agent --headless and allows usage of the Formal Desktop without a GUI. See Desktop App for more details.
August 20, 2025
New FeaturesBug Fixes

0.2.2

New
  • Added the ability to open a psql session automatically when connecting to a PostgreSQL resource through formal ls.
  • Added a permanent “latest” URL to download the latest version of the desktop app on Linux.
Fixed
  • Fixed a bug where the desktop app could become unresponsive when connecting to a resource.
August 14, 2025
New FeaturesBug Fixes

0.2.1

Fixed
  • Fixed a visual bug with the formal ls UI where a resource would not update its status after a connection request

0.2.0

New
  • Added the ability to open an SSH session automatically when connecting to an SSH resource through formal ls
August 1, 2025
New Features

0.1.4

New
  • Added support for Linux
May 20, 2025
New Features

0.1.0

New
  • Added support for configuring the SSH client (i.e., ~/.ssh/config) to more seamlessly connect to SSH, EC2, and ECS Fargate resources using the formal ls UI
March - April 2025
Improvements

0.0.91

Fixed
  • Fixed versioning issue

0.0.90

Fixed
  • Fixed versioning issue

0.0.89

New
  • Added a link to download the latest version of the desktop app if an update is available

0.0.88

Changed
  • Ensured errors are printed to stderr rather than stdout to provide a clean output stream to users

0.0.87

New
  • Exposed certain classes of connection errors between the local proxy and the Formal Connector to users
January - February 2025
Bug FixesNew Features

0.0.86

Fixed
  • Fixed authentication failures

0.0.85

New
  • Added support for using formal@<native-user> as the username to specify the native user

0.0.84

New
  • Added support for json option to formal auth credentials -o

0.0.83

New
  • Added support for json option to formal auth credentials -o

0.0.82

Fixed
  • Avoided crashing on EOF for postgres

0.0.81

Fixed
  • Fixed desktop app auth status
2024 Releases
New FeaturesBug Fixes

0.0.80

Fixed
  • Fixed desktop app auth status

0.0.79

New
  • Added support for MongoDB smart routing

0.0.78

Fixed
  • Fixed typo in error message missing S3 resource name

0.0.77

New
  • Added support for TCP Proxy and Relays

0.0.75

Changed
  • Removed the use of AWS profile

0.0.74

Changed
  • Removed the use of AWS profile

0.0.73

Changed
  • Added more efficient routing

0.0.72

Fixed
  • Fixed support for dynamodb

0.0.71

New
  • Added resource subdomain to Kubernetes resources for connectors

0.0.70

New
  • Added support for connectors

0.0.69

New
  • Added support for basic auth for clickhouse

0.0.68

New
  • Added resource to policy evaluation

0.0.67

Changed
  • Updated desktop app to renew key every 18 hours

0.0.66

New
  • Added support for connector in policy evaluation

0.0.65

Changed
  • Updated log message for fetchCABundle

0.0.64

Changed
  • Added more logs to the dynamodb command

0.0.63

Changed
  • Removed posthog

0.0.62

Fixed
  • Fixed AWS CLI

0.0.61

Fixed
  • Fixed AWS CLI

0.0.60

New
  • Added AWS CLI to building process

0.0.59

New
  • Added support for certificate bundle dynamodb

0.0.58

New
  • Added support for API Token expiration