Skip to main content

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.
lim companies list
ID                                    Name                    Role      Created
──────────────────────────────────────────────────────────────────────────────
01926f3a-1234-7abc-8def-000000000001  My Startup Inc.         owner     2026-01-15
01926f3a-1234-7abc-8def-000000000002  Side Project LLC        admin     2026-02-20
01926f3a-1234-7abc-8def-000000000003  Client Corp (advisory)  member    2026-03-01
──────────────────────────────────────────────────────────────────────────────
Active: My Startup Inc. (01926f3a-...001)
The active company is highlighted. All commands that require a company context use the active company by default.
FlagDescription
--formatOutput format: table, json, csv

companies use

Set the active company for subsequent commands.
lim companies use <company-id>
✅ Active company set to: My Startup Inc. (01926f3a-...001)
You can also use a partial ID:
lim companies use 001
# => ✅ Active company set to: My Startup Inc. (01926f3a-...001)
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 a default Japanese chart of accounts (勘定科目) and standard tax codes.
lim companies create --name "My Startup Inc."
✅ Created company: My Startup Inc.
   ID: 01926f3a-1234-7abc-8def-000000000001
   Chart of accounts: 76 accounts (Japanese standard)
   Tax codes: 8 codes (consumption tax 10% / 8%)
   Fiscal year: April - March

🔄 Set as active company.

Flags

FlagDescriptionDefault
--nameCompany name (required)
--fiscal-startFiscal year start month (1-12)4 (April)
--industryIndustry for simplified tax (1-6)
--currencyBase currency codeJPY
After creating a company, lim seeds a Japanese chart of accounts following the standard structure used by most SMBs. You can customize it with lim accounts commands.

Fiscal Year

Japanese companies typically use April-March fiscal years. lim defaults to this but you can set any start month:
# Calendar year (January - December)
lim companies create --name "Global Corp" --fiscal-start 1

# October fiscal year
lim companies create --name "Retail Co" --fiscal-start 10