Skip to main content
Asymptote hooks into Factory’s Droid agent to automatically evaluate every file edit against your security policies as Droid works.

Prerequisites

  • Asymptote CLI installed (asym command)
  • A Factory account with Droid configured
  • Logged in to your Asymptote account (asym login)

Setup

1

Install the Asymptote CLI

Install the CLI via Homebrew:
brew install asymptote-cli
Then log in:
asym login
2

Install hooks for Factory

Run the install command. By default, hooks are installed at the user level (~/.factory/settings.json) and apply to all projects:
asym factory install
To install only for the current project:
asym factory install --project
3

Run Droid

Start a Factory Droid session as normal. Asymptote will evaluate every file edit against your security policies automatically—no changes to your workflow are required.

How it works

Once installed, Asymptote registers four hooks in Factory’s settings.json:
HookPurpose
SessionStartInitializes the session and performs cleanup
PostToolUseSubmits diffs for async security evaluation
StopPolls results and re-prompts Droid on violations
SessionEndFinal cleanup
Droid will automatically remediate any policy violations before finishing its response.

Uninstalling

To remove the Asymptote hooks from Factory:
asym factory uninstall
To remove project-level hooks only:
asym factory uninstall --project

Next steps