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
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.
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
companies use
Set the active company for subsequent commands. You can use the company ID, slug, or exact name.
lim companies use my-startup-inc
Active company set to My Startup Inc.
lim companies use my-startup-inc
lim companies use 01926f3a-1234-7abc-8def-000000000001
lim companies use "My Startup Inc."
The active company is stored in ~/.config/lim/config.json. You can override it per-command with --company <id>.
companies create
Create a new company. This initializes default accounts, tax codes, and fiscal periods, then sets the new company as your active company.
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
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 | — |
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.
companies show
Show the active company’s profile in a structured format.
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.
lim companies update \
--slug my-startup-inc \
--timezone America/Los_Angeles \
--tax-registration-number EU123456789
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:
# Japan-oriented defaults
lim companies create --name "株式会社サンプル"
# US-oriented defaults
lim companies create --name "Acme, Inc." --country-code US
