> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started

<Tip>
  Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.
</Tip>

[Source: node-sdk/src/agent.ts](https://github.com/nottelabs/notte/blob/main/node-sdk/src/agent.ts)

## Create Agent

Use [NotteClient.Agent](/typescript-sdk-reference/client/agent) to create this object from your configured client.

```typescript theme={null}
client.Agent(options: AgentConstructor): Agent;
```

<ParamField body="options" type={"AgentConstructor"} required />

## Related types

* [AgentConstructor](/typescript-sdk-reference/types/agentconstructor)

## Usage

* [run](/typescript-sdk-reference/agent/run): Run agent task (blocking) - mirrors Python run method behavior This is the main method that mirrors the Python SDK's run method
* [start](/typescript-sdk-reference/agent/start): Start an agent task (non-blocking) - mirrors Python start method
* [stop](/typescript-sdk-reference/agent/stop): Stop the agent - mirrors Python stop method
* [status](/typescript-sdk-reference/agent/status): Get agent status - mirrors Python status method
* [hasStarted](/typescript-sdk-reference/agent/hasstarted): Whether `start()`/`run()` was called on this instance (or it was built from an agent id). This is a local check and does not contact the API.
* [isActive](/typescript-sdk-reference/agent/isactive): Whether the agent is still active on the server. Fetches the current status, like calling `agent.status()` in Python; an agent that was never started is not active.

<Accordion title="Direct constructor reference">
  ```typescript theme={null}
  new Agent(client: NotteClient, options: AgentConstructor): Agent;
  ```

  <ParamField body="client" type={"NotteClient"} required />

  <ParamField body="options" type={"AgentConstructor"} required />

  ## Related types

  * [AgentConstructor](/typescript-sdk-reference/types/agentconstructor)
</Accordion>

<Accordion title="Properties">
  ### agentId

  ```typescript theme={null}
  agentId: string
  ```

  Get agent ID - mirrors Python agent\_id property

  ### sessionId

  ```typescript theme={null}
  sessionId: string
  ```

  Get session ID - mirrors Python session\_id property
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.