Integrations

Integrations connect ArchNGN to external systems, allowing you to ingest metadata and keep your architectural models aligned with what is actually deployed.

Available Integrations

GitHub

Authenticate with a GitHub personal access token to:

• Crawl repositories and identify application components
• Parse dependency files to discover technology dependencies
• Use AI to read README files and generate object descriptions

Setting Up an Integration

1. Navigate to Integrations in the left sidebar.
2. Click Create Integration.
3. Select the integration type and provide the required credentials (e.g., GitHub token).
4. Configure the integration scope (e.g., which repositories to scan).
5. Save the integration.

Running an Integration

Integrations are triggered manually. From the Integrations page:

1. Locate the integration you want to run.
2. Click Run to start the sync.
3. The integration runs as a background job — monitor progress on the Jobs page.

Each integration run creates or updates objects and associations in the active workspace based on the external data. Results and history are stored for each run.

Managing Integration Data

• View history — See all previous runs, their status, and results
• Re-run — Trigger a fresh sync at any time
• Delete — Remove an integration, with the option to also delete all objects and associations it created

Token Usage

Integration tasks consume 2 tokens per execution from your account allowance.