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

# lim companies

> Create, inspect, update, and switch between companies.

# lim companies

Manage companies in your lim account. A company is the top-level container for all accounting data: chart of accounts, journal entries, reports, and rules.

## companies list

List all companies you have access to.

```bash theme={null}
lim companies list
```

```yaml theme={null}
companies[2]:
  - id: 01926f3a-1234-7abc-8def-000000000001
    name: My Startup Inc.
    slug: my-startup-inc
    countryCode: US
    currency: USD
    fiscalYearStart: 1
    timezone: America/New_York
    role: owner
    active: true
  - id: 01926f3a-1234-7abc-8def-000000000002
    name: Side Project LLC
    slug: side-project-llc
    countryCode: JP
    currency: JPY
    fiscalYearStart: 4
    timezone: Asia/Tokyo
    role: admin
```

The list output is intentionally slim. It shows only operator-facing fields instead of the raw database row.

## companies use

Set the active company for subsequent commands. You can use the company ID, slug, or exact name.

```bash theme={null}
lim companies use my-startup-inc
```

```text theme={null}
Active company set to My Startup Inc.
```

Examples:

```bash theme={null}
lim companies use my-startup-inc
lim companies use 01926f3a-1234-7abc-8def-000000000001
lim companies use "My Startup Inc."
```

<Tip>
  The active company is stored in `~/.config/lim/config.json`. You can override it per-command with `--company <id>`.
</Tip>

## companies create

Create a new company. This initializes default accounts, tax codes, and fiscal periods, then sets the new company as your active company.

```bash theme={null}
lim companies create \
  --name "My Startup Inc." \
  --slug my-startup-inc \
  --country-code US \
  --currency USD \
  --fiscal-year-start 1 \
  --legal-entity-type corporation \
  --incorporation-date 2026-03-22 \
  --tax-id-type us_ein \
  --tax-id 12-3456789
```

```yaml theme={null}
message: Company created: My Startup Inc.
activeCompanyId: 01926f3a-1234-7abc-8def-000000000001
company:
  id: 01926f3a-1234-7abc-8def-000000000001
  name: My Startup Inc.
  slug: my-startup-inc
  active: true
  role: owner
  legalEntityType: corporation
  incorporationDate: 2026-03-22
  countryCode: US
  currency: USD
  fiscalYearStart: 1
  timezone: America/New_York
```

### Flags

| Flag                        | Description                                          | Default                     |
| --------------------------- | ---------------------------------------------------- | --------------------------- |
| `--name`                    | Company legal name                                   | Required                    |
| `--slug`                    | Globally unique company slug                         | Generated from `--name`     |
| `--country-code`            | ISO 3166-1 alpha-2 country code                      | `JP`                        |
| `--currency`                | Base currency code                                   | `JPY` for JP, `USD` for US  |
| `--fiscal-year-start`       | Fiscal year start month (1-12)                       | `4` for JP, `1` for US      |
| `--timezone`                | IANA timezone                                        | `Asia/Tokyo` or US fallback |
| `--legal-entity-type`       | Legal entity type (`kk`, `gk`, `llc`, `corporation`) | --                          |
| `--incorporation-date`      | Incorporation date (`YYYY-MM-DD`)                    | --                          |
| `--registration-number`     | Registry or incorporation number                     | --                          |
| `--corporate-number`        | Japan corporate number                               | --                          |
| `--tax-id-type`             | Tax ID type (`us_ein`, `vat`, `gst`, etc.)           | Inferred in some cases      |
| `--tax-id`                  | Tax ID / EIN / TIN                                   | --                          |
| `--tax-registration-number` | VAT / GST / qualified invoice registration number    | --                          |
| `--name-kana`               | Company name in kana                                 | --                          |
| `--industry-code`           | Industry classification code                         | --                          |

<Tip>
  Use `--slug` if you want a stable human-readable identifier for `lim companies use`. If omitted, lim generates a global unique slug from the company name.
</Tip>

## companies show

Show the active company's profile in a structured format.

```bash theme={null}
lim companies show
```

```yaml theme={null}
company:
  id: 01926f3a-1234-7abc-8def-000000000001
  name: My Startup Inc.
  slug: my-startup-inc
  active: true
  role: owner
  legalEntityType: corporation
  incorporationDate: 2026-03-22
  countryCode: US
  currency: USD
  fiscalYearStart: 1
  timezone: America/New_York
registration:
  registrationNumber: REG-123
  corporateNumber: null
tax:
  taxIdType: us_ein
  taxId: 12-3456789
  taxRegistrationNumber: null
```

## companies update

Update the active company's profile.

```bash theme={null}
lim companies update \
  --slug my-startup-inc \
  --timezone America/Los_Angeles \
  --tax-registration-number EU123456789
```

Only the fields you pass are updated. Use `lim companies show` to inspect the current profile before editing it.

## Country defaults

lim currently gives country-based defaults for Japan and the United States:

```bash theme={null}
# Japan-oriented defaults
lim companies create --name "株式会社サンプル"

# US-oriented defaults
lim companies create --name "Acme, Inc." --country-code US
```