> For the complete documentation index, see [llms.txt](https://skyforgeai.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://skyforgeai.gitbook.io/docs/start-here/getting-started.md).

# Getting Started

AI-powered ServiceNow development agent. Describe what you want — SkyForge builds it.

Four steps from nothing to your first prompt.

***

## 1 — Install

```bash
npm i -g @skyforgeai/skyforge@latest
skyforge --version
```

Needs **Node.js 22+**. If `skyforge` isn't recognized afterwards, or you're on Windows, see [Installation](/docs/start-here/installation.md) for PATH setup and the directory permission check.

***

## 2 — Run

```bash
skyforge
```

Opens the web UI at `http://127.0.0.1:4096`.

![SkyForge opens on the Hub, on the Projects tab](https://2874025704-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJEVszlHbBuPIN3VRjBS%2Fuploads%2Fgit-blob-035f60e78c932d5f50e829db53e6827aac0b9077%2Fskyforge-hub.png?alt=media)

Every project you open with SkyForge is listed here, along with any you create from this screen. The left nav is how you move between the Hub's sections; the rail on the far left holds your open projects.

Other run modes (TUI, headless, single prompt) and custom ports: [Running SkyForge](/docs/use/running-skyforge.md).

***

## 3 — Connect ServiceNow

Go to the **Instance** tab in the left nav, then **+ Add Instance** in the top right.

![The Instance tab — + Add Instance is in the top right](https://2874025704-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJEVszlHbBuPIN3VRjBS%2Fuploads%2Fgit-blob-6a0f39d230d91f1c68ec3aba7ca7a506e7809e0a%2Fhub-instance-tab.png?alt=media)

Anything added here is treated as a **deploy** instance — the one SkyForge builds against. If you want to read stories from an instance instead, add it from the **Stories** tab; the two are kept separate on purpose.

Pick an authentication method:

| Method                    | Use when                                                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **OAuth 2.0**             | Production, and anywhere you can create an OAuth client — [setup guide](/docs/connect/servicenow-connection.md#oauth-20) |
| **Basic Auth**            | Developer instances only                                                                                                 |
| **Browser Session / SSO** | SAML/Okta/Azure AD instances with no local password                                                                      |

Full walkthrough for all three: [Connecting to ServiceNow](/docs/connect/servicenow-connection.md).

***

## 4 — Connect an AI provider

In the web UI: **Settings → Connect provider**.

Or write it into `skyforge.jsonc` directly:

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "apiKey": "sk-ant-..."
    }
  },
  "model": "anthropic/claude-sonnet-4-6"
}
```

OpenAI, Gemini, Bedrock, Azure, Groq, OpenRouter, LiteLLM, and Ollama are all supported — see [AI Providers](/docs/connect/ai-providers.md).

***

## You're ready 🎉

Start a new session and try:

```
Find me 3 active incidents
```

See [Example Prompts](/docs/use/examples.md) for 30+ ready-to-use prompts across incidents, flows, catalog, ATF, Service Portal, and more.

***

## Where to next

| I want to…                                        | Page                                                                                    |
| ------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Set up OAuth properly                             | [Connecting to ServiceNow → OAuth 2.0](/docs/connect/servicenow-connection.md#oauth-20) |
| Use SkyForge inside Claude Desktop or Claude Code | [SkyForge in Claude Desktop](/docs/extend/claude-desktop.md)                            |
| Teach SkyForge my company's patterns              | [Custom Skills](/docs/use/custom-skills.md)                                             |
| Save reusable prompts                             | [Custom Prompts](/docs/use/custom-prompts.md)                                           |
| Tune permissions, agents, or analytics            | [Configuration](/docs/reference/configuration.md)                                       |
| Fix something that's broken                       | [Troubleshooting](/docs/reference/troubleshooting.md)                                   |

***

## Need help?

[Submit an issue →](https://github.com/tryskyforge/skyforgeissues)